RoboFiscalVendas e integrações
Quero emitir a nota e cobrar o cliente por Pix ou boleto. Como integrar isso?
Para emitir NFS-e e cobrar por Pix ou boleto, conecte o fluxo fiscal ao seu sistema de cobrança e acompanhe os dois resultados separadamente. A API do RoboFiscal atende à nota; a cobrança depende do banco ou provedor utilizado. O RoboFiscal também oferece avaliação de projetos sob medida. Defina quando emitir, como identificar o pagamento e o que fazer em falhas, estornos e cancelamentos.
Fatos e fontes
- O Banco Central define Pix como transferência de recursos entre contas.Fonte: Banco Central: sobre o Pix.
- A NFS-e documenta a prestação de serviços.Fonte: Gov.br: emissão de NFS-e.
- A API nacional possui operações fiscais próprias, incluindo eventos sobre notas.Fonte: Portal NFS-e: manual da API, v1.2.
- A semântica HTTP distingue receber uma solicitação de concluir seu processamento.Fonte: IETF: RFC 9110, semântica HTTP.
- O RoboFiscal oferece projetos sob medida para conectar rotinas de emissão e outros sistemas.Fonte: RoboFiscal: soluções sob medida.
Nesta página
A nota deve ser emitida antes ou depois de pagar?
Essa decisão depende do momento da prestação e da regra aplicável à operação. O meio de pagamento não resolve sozinho a competência ou a obrigação de emissão. Defina a política com a contabilidade e traduza essa decisão para o sistema: qual evento cria a cobrança, qual solicita a nota e quem trata as exceções.
Como relacionar cobrança e documento fiscal?
Guarde identificadores separados para pedido, cobrança, pagamento e nota. Use uma referência estável da prestação na API fiscal. Um pagamento pode sofrer alteração sem que isso autorize apagar o histórico da nota. Da mesma forma, uma rejeição fiscal não significa que a cobrança desapareceu.
O que um projeto de integração precisa especificar?
Descreva provedor de pagamentos, formatos de eventos, critérios de emissão, volume e tratamento de reembolsos. Inclua uma rotina de conciliação: cobrança paga sem nota, nota autorizada sem pagamento e evento repetido precisam ter destinos claros. A resposta depende dos contratos técnicos de cada serviço integrado.
| Estado | Acompanhamento necessário |
|---|---|
| Cobrança paga, nota rejeitada | Corrigir e conciliar a emissão |
| Nota autorizada, cobrança pendente | Acompanhar recebimento |
| Pagamento estornado | Avaliar efeito fiscal e procedimento |
| Evento duplicado | Reconhecer a operação já processada |
Passo a passo
- Defina o evento de emissão com a contabilidade.
- Escolha o provedor e confirme as APIs de cobrança disponíveis.
- Mapeie identificadores entre pedido, pagamento e nota.
- Implemente autenticação de eventos e controle de reenvios.
- Teste falhas parciais e mantenha uma fila de pendências.
Erros comuns
- Considerar a NFS-e um boleto ou comprovante de pagamento.
- Cancelar automaticamente um documento fiscal a cada evento de estorno.
Como o RoboFiscal ajuda
A API do RoboFiscal cuida da emissão e do acompanhamento da NFS-e. Para conectar essa etapa à cobrança, descreva seu fluxo na avaliação de soluções sob medida.
Para combinar cobrança e emissão, consulte primeiro o escopo do projeto sob medida. O cadastro grátis inicia apenas o uso do emissor disponível.
Perguntas relacionadas
O Pix usado para pagar o plano do RoboFiscal é cobrança para meus clientes?
Não. O pagamento da assinatura e a cobrança dos clientes da sua empresa são fluxos diferentes.
Existe integração pronta com qualquer banco?
Não há essa garantia. A viabilidade depende do provedor, dos acessos e do escopo do projeto.
Continue lendo
Revisado em · Equipe RoboFiscal. Versão em texto