Fale Whatsapp
API (v1.0)

Primeiros passos

A nossa API foi desenhada para funcionar como uma plataforma multiemitente, ela permite que a sua Empresa/Softhouse gerencie diversos clientes (emitentes) através de uma única assinatura de plano e integração.

Contratação

Começar a usar a plataforma seguindo os passos abaixo para liberar o seu acesso administrativo:

  1. Realize o cadastro inicial na plataforma.
  2. Acesse seu e-mail para confirmar e ativar a conta.
  3. Efetue o pagamento do plano escolhido.
  4. Após a confirmação do pagamento, você terá acesso imediato ao Painel de Gestão da Softhouse.

Ambientes da API

Antes de cadastrar qualquer emitente, é importante compreender a estrutura dos ambientes. O IntegraNotas possui dois ambientes independentes:

  • Homologação: Conectado aos ambientes oficiais de teste dos órgãos emissores.
  • Produção: Conectado aos ambientes oficiais com validade jurídica.

Nós não simulamos emissões. Todas as requisições são enviadas para os ambientes reais (SEFAZ, Prefeituras).

Cadastro do Emitente

Nenhum emitente é criado automaticamente após a contratação. Para emitir documentos, você precisa cadastrar a empresa emissora. Isso pode ser feito de duas formas:

  • Via Painel: Utilize a interface visual do Painel de Gestão da Softhouse para um cadastro rápido e manual.
  • Via API: Automatize a criação de novos emitentes direto pelo seu sistema, realizando uma requisição com o Token da Softhouse.

Upload do Certificado Digital

O envio do certificado digital A1 varia de acordo com a forma que o emitente foi criado:

  • Emitente criado pelo Painel: O upload é feito manualmente na aba Autenticação durante ou após o cadastro da empresa.
  • Emitente criado pela API: O envio deve ser feito codificando o certificado para o endpoint específico de Upload de Certificado Digital, informando o Token do Emitente.

Tokens de Autenticação

O IntegraNotas utiliza dois níveis de segurança baseados em tokens distintos. É crucial usar o token correto para cada rota.

1. Token da Softhouse

Utilizado exclusivamente para ações administrativas em massa ou de gerenciamento, como: criar novos emitentes na API, administrar dados da Softhouse e validar Webhooks.

2. Token do Emitente

Este token representa uma empresa específica. É com ele que você vai realizar o tráfego pesado: emitir notas, consultar status, cancelar documentos, enviar o certificado digital e realizar manifestações para aquela empresa.