Integração na API em modelo Padrão ou Software House.
A API do Nota Fácil pode ser utilizada de duas maneiras pelo cliente na integração.
O modelo de Software House consiste basicamente em uma empresa principal, no qual possui clientes (outras empresas) que irão emitir notas para os seus clientes finais ( podendo ser pessoa física ou jurídica). Neste modelo deverá ser seguido o seguinte fluxo:
-
Login na API;
Rota API: https://api.notafacil.io/api/docs#post-/v1/auth/login -
Cadastro da empresa (que vai ter seu próprio consumer-id, no qual é um código único da empresa);
Rota API: https://api.notafacil.io/api/docs#post-/v1/empresa/salvar -
Cadastro do certificado digital (referenciando o consumer-id no header da requisição da empresa desejada) ;
Rota API: https://api.notafacil.io/api/docs#post-/v1/certificado/salvar
Observação: Para importação do certificado digital na API será necessário ser do modelo A1 e convertido o arquivo em codificação base64. -
Cadastro do cliente (referenciando o consumer-id no header da requisição) ;
Rota API: https://api.notafacil.io/api/docs#post-/v1/cliente/salvar -
Cadastro da nota fiscal (referenciando o consumer-id no header da requisição);
Rota API: https://api.notafacil.io/api/docs#post-/v1/nfse/salvar -
Emissão da nota (referenciando o consumer-id no header da requisição).
Rota API: https://api.notafacil.io/api/docs#post-/v1/nfse/emitir
Caso a API do Nota Fácil seja utilizada modelo padrão, no qual a empresa principal irá emitir notas fiscais para seus próprios clientes (podendo ser tanto pessoa física ou jurídica), então irá seguir esse fluxo:
-
Login na API;
-
Cadastro do certificado digital;
-
Cadastro do cliente;
-
Cadastro da nota fiscal;
-
Emissão da nota.
Os links para integração são:
Ambiente de produção: https://api.notafacil.io/
Ambiente de Staging (Homologação): https://staging.app.notafacil.io/
Quaisquer dúvidas ou erros no processo de integração da API, favor entrar em contato com nosso suporte técnico através de um chamado.