Importante: esta documentação já está disponível para consulta e preparação da implementação. Porém, o evento ainda não está liberado para testes e o conteúdo pode sofrer atualizações sem aviso prévio.. Atualizaremos este artigo assim que a utilização estiver disponível.
Evento de vinculação da transação de pagamento no DFe
A rota envia também pode ser utilizada para enviar à SEFAZ um evento de Vinculação da Transação de Pagamento no DF-e (110300) de uma NFC-e. A comunicação é síncrona, portanto o retorno da requisição será a resposta do SaaS dizendo se o evento foi autorizado ou rejeitado.
Este Evento deverá ser gerado pelo emitente do DF-e sempre que se desejar vincular uma ou mais transações financeiras a um documento fiscal previamente autorizado.
Observações: É possível que a transação financeira vinculada esteja em situação iniciada, ainda pendente de pagamento e/ou liquidação (ex. boleto emitido ou QR code Pix gerado).
POST
https://managersaas.tecnospeed.com.br:8081/ManagerAPIWeb/nfce/envia
Headers
| Content-Type | Indica o tipo de arquivo | multipart/form-data |
| Authorization | Este usuário e senha são os seus dados para logar como administrador em um grupo do SaaS | Basic YWRtaW46MTIzbXVkYXI= |
Body
| Nome | Descrição |
|---|---|
| arquivo | Conteúdo do TX2 do Evento |
| grupo | Nome do grupo |
| cnpj | CNPJ do emitente da NFC-e, apenas números. |
Os campos no arquivo de Vinculação da Transação de Pagamento seguem abaixo:
| Campo | Conteúdo | Descrição | Obrigatório |
|---|---|---|---|
| Documento | E110300 | Código do Evento. | Sim |
| ChaveNota | 41260929062609000177552650000000291714467980 | Chave da NFC-e. | Sim |
| VersaoAplicativo | 1.00 | Versão do aplicativo do autor do evento. | Sim |
| SequenciaEvento | 1 | Número de sequência do evento (1 a 99). | Sim |
| DhEvento | 2026-10-07T09:00:00 | Data e hora do evento. Se não informado, é utilizada a data e hora atual. | Opcional |
| Fuso | -03:00 | Fuso horário do evento, no formato -00:00. Se não informado, é utilizado o fuso da emissão da NFC-e. | Opcional |
| OrgaoAutor | 41 (Código da UF da chave de acesso da NFC-e) | Código da UF do emitente do Evento. Para este evento é considerado o código da UF presente na chave de acesso da NFC-e. | Sim |
| tpAutor_P21 | 1 | Autor do evento. Para este evento deve ser informado: 1=Empresa Emitente. | Sim |
| nProt_P23 | 141260001727531 | Número do protocolo de autorização da NFC-e (15 dígitos). | Sim |
| idTransacao_P25 | E29062609202610070900TESTE000001 | Identificador da transação financeira, de acordo com a transação de pagamento. Diferencia maiúsculas de minúsculas. Tamanho: 2 a 35 caracteres. | Sim |
| tpMeioPgto_P26 | 17 | Código do meio de pagamento (2 dígitos), conforme a Tabela Nacional de Códigos de Meios de Pagamento (Informe Técnico 2026.001). Valores: 15=Boleto; 17=Pix QR Code dinâmico; 18=TED; 20=Pix chave ou QR Code estático; 23=Pix automático; 24=TEF / Booktransfer. | Sim |
| CNPJReceb_P27 | 29062609000177 | CNPJ completo do recebedor do pagamento (fornecedor, plataforma ou outra entidade que receba o pagamento do adquirente). Pode ser diferente do CNPJ do emitente da NFC-e. Tamanho: 14 caracteres. | Sim |
| CNPJBasePSP_P28 | 12345678 | CNPJ base da instituição financeira ou de pagamento utilizada pelo recebedor do pagamento. Tamanho: 8 caracteres. | Sim |
Retorno
Exemplo de retorno:
141260000000001,135,Evento registrado e vinculado a NF-eExemplo de retorno com rejeição da SEFAZ:
REJEITADA,41261029062609000177652650000000141100010028,1273,Rejeição: Meio de pagamento inválidoExemplo de retorno com erro:
“Palavra Exception”, “Classe da Exception”, “Mensagem de Exception”
EXCEPTION,ArquivoVinculacaoTransacaoPagamento,tpAutor_P21 incorreto. Para o evento 110300 informe 1=Empresa Emitente.
Comentários
0 comentário
Por favor, entre para comentar.