Através deste endoint é possível consultar a lista de NSNRecs vinculados a um NF3-e a partir de sua chave de acesso.
URL
Produção: POST https://nf3e.ns.eti.br/v1/util/list/nsnrecs
Dados de entrada
Os dados de entrada deste método por ser enviado no corpo da requisição em formato JSON ou como QueryString na URL do método.
| Campo | Descrição | Tipo | Ocorrência | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | A | 1-1 | |
| chNF3e | Chave de acesso da NFe-e | N | 1-1 | |
| tpAmb | Tipo do ambiente de autorização do NF3-e 1 - Produção 2 - Homologação | N | 0-1 | Valor padrão: 1 |
Exemplo de requisição
Requisição de Lista de NSNRecs
curl -X POST \
-H "Content-Type: application/json" \
-d '{"X-AUTH-TOKEN": "SEU_TOKEN", "chNF3e": "11111111111111111111111111111111111111111111", "tpAmb": 2}'\
https://nf3e.ns.eti.br/v1/util/list/nsnrecs
Dados retornados
| Campo | Descrição | Tipo | Ocorrência | Pai | Observação |
|---|---|---|---|---|---|
| status | Código de status do processamento | N | 1-1 | ||
| motivo | Descrição literal do status de processamento | A | 1-1 | ||
| nsNRecs | Objeto contendo os dados da pessoa solicitada | Array | 1-1 | Conterá itens apenas se forem encontrados nsNRecs vinculados a chave do NF3-e fornecido |
|
| nsNRecs | nsNRec vinculado | N | 1-1 | nsNRecs | |
| cStat | Código do status do nsNRec | N | 1-1 | nsNRecs | |
| xMotivo | Descrição literal do status do nsNRec | A | 1-1 | nsNRecs |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "Consulta realizada com sucesso",
"nsNRecs": [
{
"cStat": 437,
"nsNRec": 4,
"xMotivo": "Rejeição: A soma das tarifas aplicadas não pode ser maior que o valor unitário do item [nItem:1]"
},
{
"cStat": 437,
"nsNRec": 5,
"xMotivo": "Rejeição: A soma das tarifas aplicadas não pode ser maior que o valor unitário do item [nItem:1]"
},
{
"cStat": 437,
"nsNRec": 6,
"xMotivo": "Rejeição: A soma das tarifas aplicadas não pode ser maior que o valor unitário do item [nItem:1]"
},
{
"cStat": 100,
"nsNRec": 7,
"xMotivo": "Autorizado o uso da NF3e "
}
]
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -2 | Chave de acesso inválida |
| -6 | Erro ao carregar as informações |