Para quem integra a Sudrel a outro sistema: autenticação por chave, emissão e consulta de NFS-e pela API, paginação, idempotência, webhooks assinados e os erros mais comuns, com exemplos de chamada.
Todos os artigos de APIs.
O esqueleto da DPS no leiaute v1.01, grupo a grupo, com os campos obrigatórios e a ordem que o schema exige: prestador, tomador, serviço, valores, tributos, IBS e CBS e assinatura. Tirado do XSD oficial.
Toda chamada à API da Sudrel fica 30 dias no painel, com o que foi enviado e o que voltou, e senhas mascaradas. Como achar a chamada pelo X-Request-Id ou pela referência da nota, e o que fazer depois.
A rota de prontidão da Sudrel diz, item por item, se a empresa pode emitir: certificado, regime tributário, plano de emissão e o que só avisa. O que é o 412 empresa_nao_pronta e o webhook que avisa quando algo muda.
A linha de comando do SDK da Sudrel lê os eventos da sua conta e entrega cada um no endereço local, assinado como o webhook real. Como usar, as opções e o que testar no seu recebedor.
npm install @sudrel/sdk ou composer require sudrel/sdk: a primeira nota com 4 campos, retentativa com idempotência que nunca duplica nota, erros tipados, paginação, webhook verificado e simulador de falhas no sandbox.
O validador gratuito da DPS mostra onde está o erro, a ordem dos campos do grupo e os valores aceitos, e confere as regras que a Sefin mais rejeita. Aceita a DPS ou a NFS-e autorizada. Como ler cada parte.
Para quem integra: a E1235 diz que o XML da DPS não passou na validação do schema. Data e hora sem fuso ou com milissegundos, competência sem traço, identificador com tamanho errado, assinatura e campo fora de ordem, com os casos reais.
A resposta não chegou: a nota saiu ou não? Como Idempotency-Key, referência e a consulta da DPS impedem nota dobrada na emissão por API.
A chave de teste emite no ambiente de testes do Sistema Nacional, e o simulador provoca timeout, rejeição e Sefin fora do ar. Quando usar cada um.
Empresa, tomador, valor e descrição: o que a API de emissão da Sudrel pede, de onde vem o resto e como a resposta explica cada campo preenchido.
Um checklist técnico para o time de TI se preparar antes de iniciar a integração com uma API de consulta de notas recebidas.
Respostas diretas às dúvidas técnicas mais comuns de desenvolvedores que integram APIs de consulta de notas de serviço.
Um glossário direto dos principais termos técnicos usados em documentação de APIs de notas fiscais de serviço.
Boas práticas para validar os dados de notas de serviço retornados por uma API antes de usá-los em rotinas internas.
Diferenças entre consultar notas de serviço em lote e individualmente via API, e quando cada abordagem faz mais sentido.
Os códigos de retorno e erros mais comuns ao consultar notas fiscais via API, e como interpretar cada um deles.
Por que o certificado digital da empresa é exigido para autenticar consultas via API de notas de serviço e como isso funciona na prática.
Pontos técnicos e de negócio para avaliar antes de integrar uma API de consulta de notas de serviço recebidas ao seu sistema.
Como a API de notas tomadas do Ambiente Nacional retorna as notas de serviço emitidas contra um CNPJ em um período.
Entenda o que é e para que serve uma API de consulta de notas de serviço recebidas, e como ela substitui a checagem manual em cada portal.
Do primeiro monitoramento à automação completa do seu fiscal de entrada.
Recebimento e gestão das notas de serviço dos seus fornecedores.
38 artigosNovidades e impactos do padrão nacional da NFS-e.
59 artigosAcompanhe em tempo real tudo que entra na sua operação.
15 artigosEndpoints, referências e boas práticas de integração.
20 artigosConecte a Sudrel ao seu ERP e às suas ferramentas.
34 artigosFluxos que eliminam o trabalho manual do fiscal de entrada.
10 artigosMonitoramento de notas de produto e conhecimentos de transporte, recebidos e emitidos.
25 artigosEmita notas de serviço em massa por planilha, sem ERP nem integração técnica.
168 artigosA situação de cada município: quem já emite pelo padrão nacional e quem ainda emite pela prefeitura.
16 artigosUm resumo mensal com o que importa: mudanças no Ambiente Nacional, novos recursos e guias práticos. Sem ruído.