Developers / Empresas
Empresas

Logo

Logo do contribuinte, usado no DANFE (PDF de pré-visualização e no que sai anexado à resposta de emissão). Formato base64 -- nunca multipart/form-data, mesmo padrão já usado em Certificado Digital.

Cadastrar / substituir POST

POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/logo

Reenviar substitui o logo anterior -- não existe histórico, só o logo atual.

CampoObrigatórioObservação
arquivo_base64SimConteúdo da imagem em Base64.
content_typeSimPrecisa começar com image/ (ex.: image/png, image/jpeg, image/svg+xml).
⚠️
Limite de 500KB por arquivo -- acima disso, 400 explícito pedindo uma imagem menor.
curl -X POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/logo \
  -H "Authorization: Bearer cf_live_51JqK..." \
  -H "Content-Type: application/json" \
  -d '{
    "arquivo_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",
    "content_type": "image/png"
  }'

Resposta

{
  "status": "OK",
  "logo": {
    "content_type": "image/png",
    "tamanho_bytes": 68
  }
}

Consultar GET

GET https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/logo

Devolve o arquivo completo em base64 (não só metadados) -- {"logo": null} se o contribuinte ainda não tiver logo cadastrado.

{
  "logo": {
    "content_type": "image/png",
    "arquivo_base64": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=",
    "tamanho_bytes": 68
  }
}

Remover POST

POST https://areacliente.centralfiscal.com.br/v1/contribuintes/{contribuinte_id}/logo/remover

Sem corpo. Resposta {"status": "REMOVIDO"}.

Também dá pra enviar o logo já na hora do cadastro -- ver campo logo em Cadastrar Empresa, atalho pra evitar uma chamada extra.