Consulta automática de NFS-e tomadas, dentro do seu produto.

É a busca automática das notas fiscais de serviço emitidas contra o CNPJ de uma empresa, ou seja, os serviços que ela contratou. A Spedy consulta o Ambiente de Dados Nacional da NFS-e com o certificado digital da empresa e devolve os documentos estruturados para o seu sistema, por API e webhook.

Para quem desenvolve software: ERPs, SaaS de gestão, plataformas e software houses que atendem várias empresas e querem oferecer contas a pagar de serviços, conferência de retenções ou rotina fiscal sem depender do cliente baixar nota no portal da prefeitura.

Do Ambiente de Dados Nacional (ADN) do Sistema Nacional NFS-e, que reúne os documentos dos municípios e distribui para quem é parte da nota. A cobertura é a dos municípios que compartilham documentos com o ambiente nacional: quem não compartilha não aparece por esse canal. A Spedy não busca em portal de prefeitura, e é isso que mantém a integração estável.

Não. Ao contrário da NF-e, a NFS-e chega completa: XML autorizado e DANFSe ficam disponíveis no momento da importação. Por isso não existe o webhook inbound_invoice.completed para NFS-e.

Por webhook. A Spedy dispara inbound_invoice.detected quando a nota chega e inbound_invoice.event a cada evento registrado no Ambiente Nacional: cancelamento, manifestação e os demais eventos do padrão nacional. Existe sincronização sob demanda, mas ela tem limite de chamadas por CNPJ e não deve ser usada para descobrir notas novas.

As notas em que a empresa aparece como tomadora do serviço e as em que ela é intermediária da operação. As notas que a própria empresa emitiu como prestadora ficam de fora, para não duplicar com a emissão.

No padrão nacional são dois atos: confirmar ou rejeitar. A primeira manifestação é definitiva. Rejeitar exige um motivo de uma lista fechada (duplicidade, já emitida pelo tomador, sem fato gerador, erro na responsabilidade tributária, erro de valor, serviço ou data, ou outro) e aceita justificativa opcional de 15 a 255 caracteres. A chamada já valida tudo isso.

Quando o tomador não se manifesta, a administração pode registrar a confirmação por decurso de prazo. Depois disso a nota não aceita mais manifestação. O registro chega no seu sistema como evento, pelo mesmo webhook.

O recurso de notas recebidas no seu contrato e certificado digital A1 válido cadastrado para a empresa. Com isso, uma chamada nas configurações da empresa liga a importação de NFS-e e define a data de início. Também dá para ligar pela tela.

Até 90 dias para trás. A data de início da importação não pode ser mais antiga que isso.

Não. A NFS-e não tem consulta individual por chave de acesso: as notas chegam exclusivamente pela distribuição do Ambiente Nacional. A chave da NFS-e tem 50 dígitos, e não 44 como a da NF-e.

A importação de NFS-e roda sempre em produção, qualquer que seja o ambiente de emissão configurado para a empresa, porque lê documentos reais do Ambiente Nacional. O restante da API tem ambiente de testes normalmente.

Pouco. O recurso do contrato é o mesmo, a habilitação é outra chave nas configurações da empresa e o webhook é o mesmo: o campo model diz se o documento é NF-e (productInvoice) ou NFS-e (serviceInvoice).

Não. Dá para contratar só a consulta de NFS-e tomadas e manter a emissão onde ela está hoje. Se você já emite pela nossa API, é o mesmo contrato e a mesma chave.

É o mesmo modelo da API da Spedy: sem taxa de setup e com uma franquia mensal de notas. A franquia certa depende do volume da sua base, e é isso que o time levanta na conversa.