Neste endpoint, deverá ser enviada a NFS-e no layout aceito por uma das cidades atendidas, sendo possível a utilização dos formatos XML e JSON.
URL
Produção: POST https://nfseapi.ns.eti.br/v1/{cidade}/emissao
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;XML: application/xml ou text/xml |
Exemplo de requisição
Requisição de emissão de NFS-e em JSON
curl -X POST
\-H "Content-Type: application/xml"
\-H "X-AUTH-TOKEN: "SEU_TOKEN"
\-H "tpAmb: 1"
\-d '<Rps>...</Rps>'
\https://nfseapi.ns.eti.br/v1/canoas/emissao
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 enviada para o municipio",
"nsNRec": "1234"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | NFSe enviada para o municipio |
| -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' ou 'text/xml' |
| -400 | Campos obrigatorios nao informados: {CAMPOS} |
| -999 | Erro interno ao processar a requisicaoVerificar nodo erro |