Através do serviço de Importação de GTV-e é possível importar um XML processado pela Sefaz para nosso banco, para que assim possar ser utilizadado dentro dos serviços da NS.
Esta funcionalidade é muito utilizada em casos onde é necessário vincular eventos em um GTVe que não foi emitido pela NS.
URL
Produção: POST https://gtve.ns.eti.br/v1/gtve/import
Dados de entrada
O arquivo que deve ser enviado seria um XML de GTV-e para distribuição, ou seja, um XML já processado pela SEFAZ e autorizado pela mesma
Dados retornados
| Campo | Descrição | Observação |
|---|---|---|
| status | Código de status do processamento | |
| motivo | Descrição literal do status de processamento | |
| nsNRec | Número do protocolo de recebimento | Somente em status = -6 |
| erro | Objeto contendo os dados de erro ocorrido durante o processamento | Somente em status = -5 ou -500 |
| erro.cStat | Código de status do erro | |
| erro.xMotivo | Descrição literal do erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Importação realizada com sucesso"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -3 | Versão não reconhecida do XML |
| -4 | Erro na estrutura do XML |
| -5 | Erro ao realizar ao importar. Verificar o xMotivo |
| -6 | GTV-e já enviado, porem ainda não consultado |
| -7 | Documento ja presente na nossa base de dados |
| -8 | XML passa de 3 meses depois de sua emissão |
| -9 | Situação diferente das permitidas(Autorizado) |
| -500 | Erro interno ao realizar a requisição Verificar o motivo |