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 enviarmos um evento de Vinculação da Transação de Pagamento no DF-e (110300) de uma NF-e para a SEFAZ, 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/nfe/envia
Headers
| Nome | Descrição | Exemplo |
| 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 NF-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 NF-e. | Sim |
| VersaoAplicativo | 1.00 | Versão do aplicativo do autor do evento. | Sim |
| SequenciaEvento | 1 | Número de sequência do evento. | Sim |
| DataHoraEvento | 2026-10-07T09:00:00 | Data e hora de emissão do evento. | Opcional |
| OrgaoAutor | 41 (Código da UF da chave de acesso da NF-e) | Código da UF do emitente do Evento. Para este evento é considerado o código da UF presente na chave de acesso da NF-e. | Sim |
| tpAutor_P21 | 1 | Autor do evento: Valores: 1=Empresa Emitente. Para este evento deve ser informado: 1 | Sim |
| nProt_P23 | 141260000610705 | Número do protocolo de autorização da NF-e (15 dígitos). | Sim |
| idTransacao_P25 | E29062609202610070900TESTE000001 | Identificador da transação financeira, de acordo com a transação de pagamento. Tamanho: 2 a 35 caracteres. | Sim |
| tpMeioPgto_P26 | 17 |
Código do meio de pagamento, conforme a Tabela Nacional de Códigos de Meios de Pagamento (Informe Técnico 2026.001). Valores: 15=Boleto; |
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 NF-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-e
Exemplo de retorno com rejeição da SEFAZ:
REJEITADA,41260929062609000177552650000000291714467980,1273,Rejeição: Meio de pagamento inválido
Exemplo de retorno com erro:
"Palavra Exception", "Classe da Exception", "Mensagem de Exception"
EXCEPTION,ArquivoVinculacaoTransacaoPagamento,tpMeioPgto_P26 inválido. Valores aceitos: 15, 17, 18, 20, 23, 24.
Comentários
0 comentário
Por favor, entre para comentar.