Através do evento de conciliação financeira é possível vincular o recebimento de um recurso a um determinado documento fiscal.
URL
Produção: POST https://nfe.ns.eti.br/nfe/econf
Dados de Entrada
| Campo | Descrição | Pai | Tipo | Ocorrência | Observação |
|---|---|---|---|---|---|
| X-AUTH-TOKEN | Token de acesso do usuário | 1-1 | |||
| chNFe | Chave de acesso da NF-e | 1-1 | |||
| tpAmb | Tipo do ambiente de autorização da NF-e 1 - Produção 2 - Homologação | 1-1 | |||
| dhEvento | Data e hora da ocorrência do cancelamento | 1-1 | Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00 |
||
| nSeqEvento | Número sequencial do evento | 1-1 | Sequencial do evento para o mesmo tipo de evento O autor do evento deve numerar de forma sequencial |
||
| detPag | Grupo de Informações de Pagamento | G | 1-100 | ||
| indPag | Indicador da forma de pagamento | detPag | 0-1 | 0= Pagamento à Vista 1= Pagamento à Prazo. | |
| tPag | Meio de Pagamento | detPag | 1-1 | Utilizar a Tabela de códigos dos meios de pagamentos publicada no Portal Nacional da Nota Fiscal Eletrônica |
|
| xPag | Descrição do meio de pagamento. | detPag | 0-1 | Preencher informando o meio de pagamento utilizado quando o código do meio de pagamento for informado como 99-outros. |
|
| vPag | Valor do Pagamento | detPag | 1-1 | ||
| dPag | Data do Pagamento | detPag | 1-1 | Informar no formato AAAA-MM-DD. Em caso de pagamentos agendados, informar a data da efetivação. |
|
| CNPJPag | CNPJ transacional do pagamento | detPag | 1-1 | Preencher informando o CNPJ do estabelecimento onde o pagamento foi processado/transacionado/recebido quando a emissão do documento fiscal ocorrer em estabelecimento distinto. |
|
| UFPag | UF do CNPJ do estabelecimento onde o pagamento foi processado/transacionado/recebido | detPag | 1-1 | ||
| CNPJIF | CNPJ da instituição financeira, de pagamento, adquirente ou subadquirente. | detPag | 0-1 | ||
| tBand | Bandeira da operadora de cartão de crédito e/ou débito | detPag | 0-1 | Utilizar a Tabela de Códigos das Operadoras de cartão de crédito e/ou débito publicada no Portal Nacional da Nota Fiscal Eletrônica. |
|
| cAut | Número de autorização da operação com cartões, PIX, boletos e outros pagamentos eletrônicos | detPag | 0-1 | Identifica o número da autorização da transação da operação | |
| CNPJReceb | Informar o CNPJ do estabelecimento beneficiário do pagamento | detPag | 1-1 | ||
| UFReceb | UF do CNPJ do estabelecimento beneficiário do pagamento | detPag | 1-1 |
Exemplo de Requisição
Requisição de ECONF de NFe
{
"X-AUTH-TOKEN": "SEUTOKEN",
"chNFe": "43240907364617000135550000000204031004621890",
"tpAmb": 2,
"dhEvento": "2024-09-30T09:39:00-03:00",
"nSeqEvento": "1",
"detPag": [
{
"indPag": "1",
"tPag": "01",
"xPag": "Pagamento em dinheiro",
"vPag": "100.00",
"dPag": "2023-09-22",
"CNPJPag": "07364617000135",
"UFPag": "SP",
"CNPJIF": "07364617000135",
"tBand": "02",
"cAut": "123456",
"CNPJReceb": "07364617000135",
"UFReceb": "RJ"
}
]
}
Exemplo de Retorno
Retorno com Sucesso
{
"status": 200,
"motivo": "NF-e vinculada ao ECONF com sucesso",
"retEvento": {
"cStat": 135,
"xMotivo": "Evento registrado e vinculado a NF-e",
"chEvento": "1107504324110736461700013555000000020430100006990501",
"dhRegEvento": "2024-11-07T14:18:24-03:00",
"nProt": "143240004090171",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoNFe versao=\"1.00\" xmlns=\"http://www.portalfiscal.inf.br/nfe\"><evento versao=\"1.00\"><infEvento Id=\"ID1107504324110736461700013555000000020430100006990501\"><cOrgao>43</cOrgao><tpAmb>2</tpAmb><CNPJ>07364617000135</CNPJ><chNFe>43241107364617000135550000000204301000069905</chNFe><dhEvento>2024-11-07T09:39:00-03:00</dhEvento><tpEvento>110750</tpEvento><nSeqEvento>1</nSeqEvento><verEvento>1.00</verEvento><detEvento versao=\"1.00\"><descEvento>ECONF</descEvento><verAplic>1.00</verAplic><detPag><indPag>1</indPag><tPag>01</tPag><xPag>Pagamento em dinheiro</xPag><vPag>100.00</vPag><dPag>2024-07-07</dPag><CNPJPag>07364617000135</CNPJPag><UFPag>SP</UFPag><CNPJIF>07364617000135</CNPJIF><tBand>02</tBand><cAut>123456</cAut><CNPJReceb>07364617000135</CNPJReceb><UFReceb>RJ</UFReceb></detPag></detEvento></infEvento><Signature xmlns=\"http://www.w3.org/2000/09/xmldsig#\"><SignedInfo><CanonicalizationMethod Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\" /><SignatureMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#rsa-sha1\" /><Reference URI=\"#ID1107504324110736461700013555000000020430100006990501\"><Transforms><Transform Algorithm=\"http://www.w3.org/2000/09/xmldsig#enveloped-signature\" /><Transform Algorithm=\"http://www.w3.org/TR/2001/REC-xml-c14n-20010315\" /></Transforms><DigestMethod Algorithm=\"http://www.w3.org/2000/09/xmldsig#sha1\" /><DigestValue>gaLxcm+h25h+R8qhfCM3j9Dx4d8=</DigestValue></Reference></SignedInfo><SignatureValue>HpPKyjqglgnVzPcTykdG7euZjvBbCNY3vA24FjiL4FHF9PB19vdTmLfVAHJkRFTkPmRe5mS25iaMG6/VrQnG0kyre8tBqMRe8N3nR/SwCByUCSMVoTp8EuN8RL0PnmwUIm406OhOtMsId6uaBJJmFLHzmvVXpHupvXKaWCew4GaTjVVxYzCaVEdn10lSIh7BbOhMNRBrXbZk6vaqPRPmUjr3MrasqjhPc4dKwre5MYReH4aQ6hoEQurmKRZ86xp77VnCK1NDnLJGDrDzmBLbMlJXVsGAAk7zO72NCV+ly5aqGrlYJrVnzy+rJhU4qfeViyJzg6kcqbGxgI7W8v+3Rw==</SignatureValue><KeyInfo><X509Data><X509Certificate>MIIH1jCCBb6gAwIBAgIIcMo+fYddL7cwDQYJKoZIhvcNAQELBQAwdjELMAkGA1UEBhMCQlIxEzARBgNVBAoTCklDUC1CcmFzaWwxNjA0BgNVBAsTLVNlY3JldGFyaWEgZGEgUmVjZWl0YSBGZWRlcmFsIGRvIEJyYXNpbCAtIFJGQjEaMBgGA1UEAxMRQUMgU0FGRVdFQiBSRkIgdjUwHhcNMjQwODE2MTczNTA0WhcNMjUwODE2MTczNTA0WjCB6zELMAkGA1UEBhMCQlIxEzARBgNVBAoTCklDUC1CcmFzaWwxCzAJBgNVBAgTAlJTMRAwDgYDVQQHEwdDQU1BUVVBMTYwNAYDVQQLEy1TZWNyZXRhcmlhIGRhIFJlY2VpdGEgRmVkZXJhbCBkbyBCcmFzaWwgLSBSRkIxFjAUBgNVBAsTDVJGQiBlLUNOUEogQTExFzAVBgNVBAsTDjQ3MTE4MDc3MDAwMTI0MRMwEQYDVQQLEwpwcmVzZW5jaWFsMSowKAYDVQQDEyFORVcgUyBTWVNURU1TIExUREE6MDczNjQ2MTcwMDAxMzUwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDCi67b28zFgTj7lTsWRDuZjIBYLqAa2sgsih27Vjo2wXjJfaHDcG6RJ6ion7I5A5k5175ADxEr8bZAkb8cDlKLw+YcnYWC5YUhdhuceteRPH2tn7beVXCR7ToRDaoFMppe4e9I9aWqLuZnbHs/DGwj4y46YVPOTQa40lp2etD6pPf1KaJZ+1zVW4h3FGknYXAzOGz7sgGXitadL3+wIMAqhaMfQFpvxika5qzqPsnf5GX0FWSddGSi84nh3mXTHxyV6tystWWi5WZgE8ZxKaBRcC5R9Gc4IT2oqcTnsHSdR1s0g7IMqCopKzvt4mPbvnMxeVdd4v99Ujjyz9Tpg5QFAgMBAAGjggLwMIIC7DAfBgNVHSMEGDAWgBQpXkvVRky7/hanY8EdxCby3djzBTAOBgNVHQ8BAf8EBAMCBeAwaQYDVR0gBGIwYDBeBgZgTAECATMwVDBSBggrBgEFBQcCARZGaHR0cDovL3JlcG9zaXRvcmlvLmFjc2FmZXdlYi5jb20uYnIvYWMtc2FmZXdlYnJmYi9kcGMtYWNzYWZld2VicmZiLnBkZjCBrgYDVR0fBIGmMIGjME+gTaBLhklodHRwOi8vcmVwb3NpdG9yaW8uYWNzYWZld2ViLmNvbS5ici9hYy1zYWZld2VicmZiL2xjci1hYy1zYWZld2VicmZidjUuY3JsMFCgTqBMhkpodHRwOi8vcmVwb3NpdG9yaW8yLmFjc2FmZXdlYi5jb20uYnIvYWMtc2FmZXdlYnJmYi9sY3ItYWMtc2FmZXdlYnJmYnY1LmNybDCBtwYIKwYBBQUHAQEEgaowgacwUQYIKwYBBQUHMAKGRWh0dHA6Ly9yZXBvc2l0b3Jpby5hY3NhZmV3ZWIuY29tLmJyL2FjLXNhZmV3ZWJyZmIvYWMtc2FmZXdlYnJmYnY1LnA3YjBSBggrBgEFBQcwAoZGaHR0cDovL3JlcG9zaXRvcmlvMi5hY3NhZmV3ZWIuY29tLmJyL2FjLXNhZmV3ZWJyZmIvYWMtc2FmZXdlYnJmYnY1LnA3YjCBuAYDVR0RBIGwMIGtgRpUSElBR09ATlNURUNOT0xPR0lBLkNPTS5CUqAhBgVgTAEDAqAYExZUSElBR08gREEgU0lMVkEgRFVNTUVSoBkGBWBMAQMDoBATDjA3MzY0NjE3MDAwMTM1oDgGBWBMAQMEoC8TLTExMDQxOTgzMDAyNjk5MjUwNzQwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMKAXBgVgTAEDB6AOEwwwMDAwMDAwMDAwMDAwHQYDVR0lBBYwFAYIKwYBBQUHAwIGCCsGAQUFBwMEMAkGA1UdEwQCMAAwDQYJKoZIhvcNAQELBQADggIBAIfuRwpglj0kSgpgTts2Aqq+HQk23H1VLZfzB/GBqE1PpIjIF9j1gLk0jQN0cnB32CVcsBfZeiTBw7jJmwmMTYQVLwCRqgPxLl8k8xXv19LUNrZOF+ByARCrtRrxBtZLfGHUPwz/U1bst+wkeYvWyAMPe2872R27ZG9k4cN18nS1EFtmlC0pfQuFs5nhyWLWNH20SoEgVoGn4ar8kvX4mKwzVuetK2V52OHgueWeKUxMOjF/z0+9FRdmXq+sSfGTxNuU0j/E939UtmmpISUTJulF+iOCsOCye75eTyhL9ufMaih2GlWB4deBoBzUn7y8BAp/pHYv+UdLiD3s94/E0gJXwBH3IXwU7mHWhHHCNaYyxwC6h96wsQQ3o7URnL1ssp91Ep2yWQkugbS+dCZxMuDqYJdALnQ/8erwbnwWcPPJuy16GicD76y0n/iX1B/s1DqfyBoRUe9z/RfPwN9cNTdqbeAAMGxE1k5/voYMF15fg8hYv+QeV+xW6MxaAhXiIXyu7AO4yR0t8E94ZY21z0UFvsi2hWlKYouRoONLLntfLtjihPX9YWNjYIoey3c0D8wBkse3dY6oPrbrjDQMbUdLq+2cwRv7uqG3ZS1JVi1+d36JgHXFQXtWo4zZIjbji7WGUDSX1zZdzs7fv9HvCP2lzYv3u6Xm9NultQPEL8fy</X509Certificate></X509Data></KeyInfo></Signature></evento><retEvento versao=\"1.00\"><infEvento><tpAmb>2</tpAmb><verAplic>SVRS2411051346</verAplic><cOrgao>43</cOrgao><cStat>135</cStat><xMotivo>Evento registrado e vinculado a NF-e</xMotivo><chNFe>43241107364617000135550000000204301000069905</chNFe><tpEvento>110750</tpEvento><nSeqEvento>1</nSeqEvento><dhRegEvento>2024-11-07T14:18:24-03:00</dhRegEvento><nProt>143240004090171</nProt></infEvento></retEvento></procEventoNFe>"
}
}
Códigos de Retorno
| Código | Descrição |
|---|---|
| 200 | NF-e vinculada ao ECONF com sucesso |
| -3 | Nao foi possivel vincular a conciliação financeira a NF-e Verifique o campo cStat e xMotivo para verificar a causa do erro |
| -4 | Evento invalido de acordo com a validacao contra schema Verifique o campo "Erros" para analisar a causa do erro |
| -400 | Verifique o campo "motivo" para mais informações do erro |
| -999 | Erro interno ao processar a requisicao Verifique o campo cStat e xMotivo para analisar a causa do erro |