Através do serviço de Importação de CTe-OS é possível importar um XML processado pela sefaz para nosso banco, para que assim possa ser utilizado dentro dos serviços da NS.
Esta funcionalidade é muito utilizada em casos onde é necessário vincular eventos em um CTe-OS que não foi emitido pela NS.
URL
Produção: POST https://cte.ns.eti.br/cte/importos
Dados de entrada
O arquivo que deve ser enviado seria um XML de CTe-OS para distribuição, ou seja, um XML já processado pela SEFAZ e autorizado pela mesma
| Campo | Ocorrêrncia | Tipo | Descrição |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | String | Token de acesso do usuário |
| XML | 1-1 | String | xml do documento a ser importado |
Exemplo de requisição
Requisição de importação de XML de CTe-OS
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"X-AUTH-TOKEN": "SEU_TOKEN",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><nfeProc versao=\"4.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><NFe>...</NFe><protNFe versao=\"4.00\">...</protNFe></nfeProc>"
}'\
https://cte.ns.eti.br/util/generatepdf
Dados retornados
| Campo | Descrição | Obeservaçã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 | CTe-OS 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 |