A API do Storage foi desenvolvida com o objetivo de permitir que o parceiro solicite a recuperação de XML através de requisições HTTP.
URL
Produção: POST https://storage.ns.eti.br/recovery
Dados de entrada
| Campo | Ocorrência | Descrição | Observação |
|---|---|---|---|
| X-AUTH-TOKEN | 1-1 | Token de Acesso do usuário | |
| CNPJLicenca | 1-1 | CNPJ da licença do emitente | Informar o CNPJ sem os pontos e traços. |
| projeto | 1-1 | Código do Projeto | ANTT: 31 BPe: 27 CTe:6 CTe OS: 26 DDFe: 22 GTVe: 30 MDFe: 21 NF3e: 29 NFCe: 20 NFe: 1 SAT: 24 |
| chave | 1-1 | chave de acesso a ser resgatada | |
| emails | 1-1 | e-mail para receber a chave solicitada no resgate |
Exemplo de requisição
Requisição para recuperação de um XML específico:
curl -X POST
-H "Content-Type: application/json"
-d '{
"X-AUTH-TOKEN":"…",
"CNPJLicenca":"07364617000135",
"projeto":"1",
"chave":"43230100063354950072559200000009961000000005",
"emails":[
"email@nstecnologia.com.br"
]
}' \
https://storage.ns.eti.br/recovery
Exemplos de retorno
//Exemplo 1:
{
"status": 400,
"message": "Chave de acesso deve conter 44 caracteres"
}
//Exemplo 2:
{
"status": 400,
"message": "CNPJ da Licença não foi informado"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Solicitação de recuperação de XML registrada com sucesso. |
| 403 | Forbidden – não informado o token |
| 401 | Unauthorized – Token de acesso inválido |
| 400 | CNPJ da Licença não foi informado |
| 404 | Licenca com cnpj 0000000000000 não encontrada. |
| 500 | Internal Server Error |