Envio de certificado
Insere ou atualiza o certificado digital utilizado por uma licença para gerenciar os documentos fiscais eletrônicos, e retorna a data de vencimento do certificado.
URL
POST https://painelapi.ns.eti.br/licenca/certificate/save
Dados de entrada
Os dados de entrada deste método devem ser enviados como dados de formulário (content-type = multipart/form-data) ou como JSON (content-type = application/json).
| Campo | Descrição | Ocorrência | Tipo | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso | 1-1 | String | |
| licencaCnpj | CNPJ do contribuinte | 1-1 | String | |
| projeto | Código do projeto | 1-1 | Integer | 1 - NS NFe; 6 - NS CTe; 20 - NS NFCe Cloud; 21 - NS MDFe Cloud; 22 - NS DDF-e |
| password | Senha do certificado | 1-1 | String | |
| file | Arquivo do certificado | 1-1 | File ou String | Se o tipo de envio for JSON, este campo será do tipo String e deverá conter o Base64 do arquivo do certificado. Se o tipo de envio for formulário, este campo será do tipo File e deverá conter o arquivo do certificado. |
Exemplo de requisição
curl -X POST
\-H "Content-Type: application/json"
\-d '{"licencaCnpj": "11111111111111", "projeto": 6, "password": "123456", "file": "BASE64 DO CERTIFICADO"}'
https://painelapi.ns.eti.br/licenca/certificate/save
JSON de envio
{
"licencaCnpj": "11111111111111",
"projeto": 6,
"password": "123456",
"file": "BASE64 DO CERTIFICADO"
}
Dados de retorno
| Código | Descrição |
|---|---|
| 200 | Certificado salvo com sucesso |
| -1 | Base64 do certificado enviada não é valida |
| -2 | Senha do certificado inválida ou arquivo enviado inválido |
| -3 | Licença não encontrada para o CNPJ e Projeto enviados |
Exemplo de retorno
{
"status": 200,
"msg": "Certificado salvo com sucesso",
"certificado": {
"vencimento": "22/10/2024 11:10:00"
}
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Certificado salvo com sucesso |
| -1 | Base64 do certificado enviada não é valida |
| -2 | Senha do certificado inválida ou arquivo enviado inválido |
| -3 | Licença não encontrada para o CNPJ e Projeto enviados |
Obter vencimento do certificado
Carrega a data de vencimento do certificado digital de uma licença.
URL
POST https://painelapi.ns.eti.br/licenca/certificate/get
Dados de entrada
| Campo | Descrição | Ocorrência | Tipo | Observação |
|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso | 1-1 | A | Token de acesso da Software House utilizada para comunicação com as APIs da NS Tecnologia |
| licencaCnpj | CNPJ da licença | 1-1 | N | |
| projeto | Código identificador do projeto da licença | 1-1 | N | 1 - NS NFe Cloud; 6 - NS CTe Cloud; 20 - NS NFCe Cloud; 22 - NS DDFe; 21 - NS MDF-e Cloud; 24 - NS SAT |
Exemplo de requisição
Requisição de vencimento de certificado
curl -X POST
\-H "Content-Type: application/json"
\-d '{"X-AUTH-TOKEN":"...","licencaCnpj":"11111111111111", "projeto":"1"}'
https://painelapi.ns.eti.br/licenca/certificate/get
Dados retornados
| Campo | Descrição | Ocorrência | Tipo | Pai | Observação |
|---|---|---|---|---|---|
| Status | Código de status do processamento | 1-1 | N | ||
| motivo | Descrição literal do status de processamento | 1-1 | A | ||
| Certificado | Objeto contendo os dados do certificado | 0-1 | O | Somente em status = 200 | |
| vencimento | Data de vencimento do certificado | 1-1 | D | certificado | Formato = dd/MM/yyyy hh:mm:ssEx.: 18/08/2017 17:45:12 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"msg": "Consulta realizada com sucesso",
"certificado": {
"vencimento": "18/08/2017 17:45:12"
}
}
Retorno com erro
{
"status": -2,
"msg": "Certificado nao encontrado com as informacoes enviadas"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Consulta realizada com sucesso |
| -2 | Certificado não encontrado com as informações enviadas |
| -400 | Requisição inválida. Veja no campo msg o motivo do erro |