Neste endpoint, a NFSe deve ser enviada no layout padrão da NFSe Nacional, sendo possível a utilização dos formatos XML e JSON.
URL
Produção: POST https://nfsenacional.ns.eti.br/nfse/issue
Header
No cabeçalho da requisição poderão ser informados os campos abaixo, conforme ocorrência.
Envio de dados em formato JSON
Para envio dos dados em JSON do Content-Type da requisição deverá ser definido como application/json.
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de NFSe no formato JSON:
Envio de dados em formato XML
Para envio dos dados em XML o Content-Type da requisição deverá ser definido como application/xml e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de NFSe no formato XML:
Header
No cabeçalho da requisição poderão ser informados os campos abaixo, conforme ocorrência.
| Campo | Ocorrência | Descrição |
|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de acesso da Software House |
| tpAmb | 1-1 | Tipo do ambiente: 1-Produção; 2-Homologação |
| Content-Type | 1-1 | Indica o formato dos dados enviados:JSON: application/json e XML: application/xml |
Exemplo de requisição
Requisição de emissão de NFSe em JSON
curl -X POST
\-H "Content-Type: application/json"
\-H "X-AUTH-TOKEN: "SEU_TOKEN"
\-H "tpAmb: 1"
\-d '<Dps>...</Dps>'
\https://nfsenacional.ns.eti.br/nfse/issue
Dados retornados
| Campo | Descrição | Pai | Observação |
|---|---|---|---|
| status | Código de status do processamento | ||
| motivo | Descrição literal do status de processamento | ||
| nsNRec | Protocolo de recebimento da NFS-e | Somente em status = 200 ou -6 | |
| erro | Objeto contendo o erro ocorrido | ||
| cStat | Código de status do erro | erro | |
| xMotivo | Descrição literal do erro | erro |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "NFSe enviado para Sefaz",
"nsNRec": 55
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | NFSe enviado para Sefaz |
| -1 | Tipo de ambiente deve ser informado no header, com valor 1(producao) ou 2(teste) |
| -2 | Tipo de ambiente invalido com valor:{VALOR} |
| -4 | Erro ao carregar os dados enviados: {ERROS} |
| -6 | Documento já Recebido, porem ainda sem status de processamento, por favor consulte o status de processamento do NSNRec informado |
| -7 | Content-Type invalido: {VALOR}. O content-type deve ser 'application/json' ou 'application/xml' |
| -400 | Campos obrigatorios nao informados: {CAMPOS} |
| -999 | Erro interno ao processar a requisicao |