1. Inicio
  2. Documentos
  3. NS GTVe
  4. Emissão na NS GTV-e API
  5. Status de Processamento

Status de Processamento

Este serviço é utilizado para consultar o status de processamento de uma GTV-e enviada anteriormente para processamento pelo método de Emissão de GTV-e.

URL

Produção: POST https://gtve.ns.eti.br/v1/gtve/issue/status

Dados de entrada
CampoOcorrênciaTipoPaiDescrição
X-AUTH-TOKEN1-1AToken de acesso da Software House
CNPJ1-1NCNPJ do emitente do GTV-e
tpAmb1-1NTipo de ambiente emitido:
1 - Produção2 - Homologação
nsNRec1-1NNúmero do protocolo de recebimento
Exemplo de requisição

Requisição de status de processamento de GTV-e

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
        "X-AUTH-TOKEN":"SEU_TOKEN", 
        "CNPJ": "11111111111111", 
        "tpAmb": "2",
        "nsNRec": 1
        }' \
https://gtve.ns.eti.br/v1/gtve/issue/status
Dados retornados
CampoDescriçãoOcorrênciaTipoPaiObservação
statusCódigo de status do processamento1-1N
motivoDescrição literal do status de processamento1-1A
chCTeChave da GTV-e1-1N
cStatCódigo de status do processamento do GTV-e na Sefaz0-1NSomente em status = 200
xMotivoDescrição literal do status de processamento na Sefaz0-1ASomente em status = 200
nProtNúmero do protocolo de autorização do GTV-e na Sefaz0-1NSomente em cStat = 100 
dhRecbtoData e hora do recebimento do GTV-e pela Sefaz0-1DSomente em status = 200
consultarNSNRecNSNRec do mesmo documento autorizado ou pendente de consulta0-1NEste campo pode aparecer em status = 200 e cStat = 539, se tivermos um nsNRec pendente de consulta ou do mesmo documento autorizado. Caso recebas este campo, consulte novamente o status de processamento com o valor dele.
xmlXML de distribuição da GTV-e0-1ASomente em cStat = 100 
erroObjeto contendo as informações de erro caso a consulta não possa ser realizada com sucesso Detalhamento no Quadro Abaixo0-1OSomente em status diferente de 200
Detalhamento do Objeto erro
CampoDescriçãoOcorrênciaTipoPai
cStatCódigo de status do erro1-1N
xMotivoDescrição literal do erro1-1A
Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "Consulta realizada com sucesso",
    "chCTe": "43210107364617000135640000000000031000010506",
    "cStat": "100",
    "xMotivo": "Autorizado o uso da CTe ",
    "nProt": "143190000000010",
    "dhRecbto": "2021-01-01T00:00:00-03:00",
    "xml": "<GTVeProc versao="3.00" xmlns="http: //www.portalfiscal.inf.br/cte"><GTVe versao="3.00"><infCte versao="3.00" Id="CTe43210107364617000135640000000000031000010506">...</infCte></GTVe></GTVeProc>"}

Retorno com erro

{
    "status": -2,
    "motivo": "Nao foi possivel carregar o status da GTV-e",
    "erro": {
        "cStat": 0,
        "xMotivo": "Documento não localizado em nosso banco de dados"
    }
}
Códigos de retorno
CódigoDescrição
200Consulta realizada com sucesso
-2Não foi possível carregar o status de processamento do GTV-e Verifique o objeto erro para maiores informações

Como podemos ajudar?