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

Campo	Ocorrência	Tipo	Descrição
X-AUTH-TOKEN	1-1	A	Token de acesso da Software House
CNPJ	1-1	N	CNPJ do emitente do GTV-e
tpAmb	1-1	N	Tipo de ambiente emitido: 1 - Produção2 - Homologação
nsNRec	1-1	N	Nú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

Campo	Descrição	Ocorrência	Tipo	Observação
status	Código de status do processamento	1-1	N
motivo	Descrição literal do status de processamento	1-1	A
chCTe	Chave da GTV-e	1-1	N
cStat	Código de status do processamento do GTV-e na Sefaz	0-1	N	Somente em status = 200
xMotivo	Descrição literal do status de processamento na Sefaz	0-1	A	Somente em status = 200
nProt	Número do protocolo de autorização do GTV-e na Sefaz	0-1	N	Somente em cStat = 100
dhRecbto	Data e hora do recebimento do GTV-e pela Sefaz	0-1	D	Somente em status = 200
consultarNSNRec	NSNRec do mesmo documento autorizado ou pendente de consulta	0-1	N	Este 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.
xml	XML de distribuição da GTV-e	0-1	A	Somente em cStat = 100
erro	Objeto contendo as informações de erro caso a consulta não possa ser realizada com sucesso Detalhamento no Quadro Abaixo	0-1	O	Somente em status diferente de 200

Detalhamento do Objeto erro

Campo	Descrição	Ocorrência	Tipo	Pai
cStat	Código de status do erro	1-1	N
xMotivo	Descrição literal do erro	1-1	A

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ódigo	Descrição
200	Consulta realizada com sucesso
-2	Não foi possível carregar o status de processamento do GTV-e Verifique o objeto erro para maiores informações

NS GTVe

URL