NS NFCe

⌘K
  1. Home
  2. NS NFCe
  3. Eventos de NFCe API
  4. Evento de Conciliação Financeira NFCe

Evento de Conciliação Financeira NFCe

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://nfce.ns.eti.br/v1/nfce/econf

Dados de Entrada

CampoDescriçãoPaiTipoOcorrênciaObservação
X-AUTH-TOKENToken de acesso do usuário1-1
chNFeChave de acesso da NFCe1-1
tpAmbTipo do ambiente de autorização da NFCe

1 - Produção
2 - Homologação
1-1
dhEventoData e hora da ocorrência do cancelamento1-1Padrão Sefaz

AAAA-MM-DDTHH:MM:SS + UTC

Ex.: 2016-06-13T15:04:10-02:00
nSeqEventoNúmero sequencial do evento1-1Sequencial do evento para o mesmo tipo de evento

O autor do evento deve numerar de forma sequencial
detPagGrupo de Informações de PagamentoG1-100
indPagIndicador da forma de pagamentodetPag
0-10= Pagamento à Vista 1= Pagamento à Prazo.
tPagMeio de PagamentodetPag1-1Utilizar a Tabela de códigos dos meios de pagamentos publicada
no Portal Nacional da Nota Fiscal Eletrônica
xPagDescrição do meio de pagamento. detPag0-1Preencher informando o meio de pagamento
utilizado quando o código do meio de pagamento for informado como 99-outros.
vPagValor do PagamentodetPag1-1
dPagData do PagamentodetPag1-1Informar no formato AAAA-MM-DD. Em caso de pagamentos agendados,
informar a data da efetivação.
CNPJPagCNPJ transacional do pagamento detPag1-1Preencher informando o CNPJ do estabelecimento onde o pagamento foi
processado/transacionado/recebido quando a emissão do documento fiscal ocorrer em
estabelecimento distinto.
UFPagUF do CNPJ do estabelecimento onde o pagamento foi processado/transacionado/recebidodetPag1-1
CNPJIFCNPJ da instituição financeira, de pagamento, adquirente ou subadquirente.detPag0-1
tBandBandeira da operadora de cartão de crédito e/ou débitodetPag
0-1Utilizar 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.
cAutNúmero de autorização da operação com cartões, PIX, boletos e outros pagamentos eletrônicosdetPag
0-1Identifica o número da autorização da transação da operação
CNPJRecebInformar o CNPJ do estabelecimento beneficiário do pagamentodetPag1-1
UFRecebUF do CNPJ do estabelecimento beneficiário do pagamentodetPag1-1


Exemplo de Requisição
Requisição de ECONF de NFCe

{
    "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": "..."
    }
}

Códigos de Retorno

CódigoDescrição
200NF-e vinculada ao ECONF com sucesso
-3Nao foi possivel vincular a conciliação financeira a NF-e

Verifique o campo cStat e xMotivo para verificar a causa do erro
-4Evento invalido de acordo com a validacao contra schema

Verifique o campo "Erros" para analisar a causa do erro
-400Verifique o campo "motivo" para mais informações do erro
-999Erro interno ao processar a requisicao

Verifique o campo cStat e xMotivo para analisar a causa do erro

How can we help?