Através deste método é possível enviar uma imagem que será utilizada como logotipo do contribuinte na impressão dos documentos emitidos.
A imagem enviada deve estar no formato PNG ou JPG e conter no máximo 500KB.
URL
POST https://painelapi.ns.eti.br/licenca/logo/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 | String | 1 - NS NFe; 6 - NS CTe; 20 - NS NFCe; 21 - NS MDFe; 26 - NS CTe OS; 27 - NS BPe |
| Imagem do logotipo | 1-1 | String | Se o tipo de envio for JSON, este campo será do tipo String e deverá conter o Base64 da imagem do logotipo. Se o tipo de envio for formulário, este campo será do tipo File e deverá conter o arquivo do logotipo. A imagem deve estar no formato PNG ou JPG e conter no máximo 500KB. |
Exemplo de requisição
Envio de logotipo em JSON
curl -X POST
\-H "Content-Type: application/json"
\-d '{"licencaCnpj": "11111111111111", "projeto": 20, "logo": "BASE64 DA IMAGEM"}'
https://painelapi.ns.eti.br/licenca/logo/save
Dados de retorno
| Campo | Descrição |
|---|---|
| status | Código de status da requisição |
| msg | Descrição literal do status da requisição |
Exemplo de retorno
{
"status": 200,
"msg": "Logotipo atualizado com sucesso"
}
Códigos de retorno
| Código | Descrição |
|---|---|
| 200 | Logotipo atualiza com sucesso |
| -1 | CNPJ do emitente não informado |
| -2 | Código do projeto não informado |
| -3 | Nenhum arquivo enviado ou não enviado no campo 'logo' |
| -4 | Tipo de arquivo inválido, diferente de PNG ou JPG |
| -5 | Licença não encontrada para o CNPJ e Projeto enviados |
| -6 | Nenhum dado enviado ou dados enviados com o Content-Type diferente de 'multipart/form-data' |
| -7 | Tamanho do arquivo excede o limite máximo de 500KB |
| -8 | Base64 enviada não é válida |