Para que possa conciliar os dados registrados com rapidez e assertividade, basta seguir os passos as seguir:
Passo 1 - Solicitação de Conciliação
Para solicitar uma conciliação, utilize o EndPoint de Conciliação.
Selecione a data da conciliação e envie a solicitação de conciliação.
Assim como nossos demais processos, a conciliação funciona de maneira assíncrona, portanto, ao enviar uma solicitação nova, receberá uma mensagem de aceite, e, assim que o processamento estiver concluído, receberá uma notificação na URL pré-cadastrada (clique aqui para rever como funciona a Notificação).
A notificação conterá uma chave, uma URL para um Bucket de dados, onde poderá baixar o Arquivo para Conciliação, o estado atual da conciliação (será sempre pending), a data selecionada para a conciliação e um relatório simples, contendo a contagem dos registros enviados, e a somatória do valor de expectativa de liquidação correspondente, conforme exemplo abaixo:
{
"data": {
"reconciliationKey":"f3605d8f-4709-49c8-8ce",
"extractionReferenceDate":"2020-12-05",
"recipient":"88888888888888",
"recipientDocumentType":"CNPJ",
"reconciliationStatus":"processing",
"message":"There is no register for reconciliation",
"urls":[
"https://api.receivable.staging.taginfraestrutura.com.br/reconciliation/file/56614efa-5026-4c6c-93ad-3b406729effb"
],
"processKey":"1b05dee4-da0c-436f-8fc0-513ff14",
"createdAt":"2020-12-05T23:10:15.2268055Z"
},
"eventType": "reconciliation",
"processKey": "17f19e47-fd4e-45c8-987c-458050a9b602",
"createdAt": "2023-02-01T21:17:14.330911Z"
}
A requisição se manterá como pendente até que a conciliação dos dados seja confirmada.
Para confirmar a conciliação e, assim, encerrar a requisição, realize as ações descritas no passo 3.
Passo 2 - Download do Arquivo para Conciliação
Utilizando a URL do Bucket enviado, faça o download do arquivo para conciliação.
O arquivo para conciliação do tipo JSON Lines.
Segue um exemplo de um arquivo para conciliação:
{"key": "471ee464-6781-4e34-8180-d703a96d0ece","dueDate": "2023-02-05T00:00:00","paymentScheme": "ECD","debtor": "29934986000159","originalAssetHolderDocumentType": "CNPJ","originalAssetHolder": "29934986000159","amount": 0,"prePaidAmount": 0,"createdAt": "2022-03-28T12:11:18.5296712Z","lastUpdated": "2022-08-04T12:40:18.2641429Z","settlementObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","totalAmount": 0,"settledAmount": 0,"balanceAmount": 0,"committedAmount": 0,"uncommittedAmount": 0,"dueDate": "2023-02-05T00:00:00","expectedSettlementDate": "2023-02-05T00:00:00","originalAssetHolder": "29934986000159","originalAssetHolderDocumentType": "CNPJ","assetHolder": "29934986000159","assetHolderDocumentType": "CNPJ","obligationType": "Committed","lastUpdated": "2022-08-04T12:40:18.2363337Z","settlements": [],"contractObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","reference": "1663df5f-e400-4508-be13-19b73d1cada8","contractHolderDocumentType": "CNPJ","contractHolder": "29934986000159","effectPriority": 1,"contractType": "Warranty","warrantyType": "Fiduciary","divisionMethod": "Percentage","effectStrategy": "Specific","effectAmount": 800,"committedEffectAmount": 0,"bankAccount": {"branch": "769","account": "17266","accountDigit": "9","accountType": "CC","ispb": "00000000","documentType": "CNPJ","documentNumber": "29934986000159"},"createdAt": "2022-03-28T12:11:07.0116071Z","lastUpdated": "2022-08-04T12:40:18.2363266Z","isCanceled": false}],"financialOperationEvents":[{ "createdAt": "2020-12-05T18:28:14.2782199Z", "eventSourceReferenceKey": "57f95c79-b0d7-4f8d-9623-ed345b585800", "eventType": "Registry", "operationAmount": 1000, "operationEventType": "Creation", "processDate": "2020-12-05T18:28:14.2782223Z","processkey": "addf4ea4-341d-4cbe-a364-7b0d5b577f69"}]}]}
{"key": "cb6c71a7-04d7-4cd2-8344-4892bcb3ee34","dueDate": "2023-02-06T00:00:00","paymentScheme": "ECD","debtor": "29934986000159","originalAssetHolderDocumentType": "CNPJ","originalAssetHolder": "29934986000159","amount": 0,"prePaidAmount": 0,"createdAt": "2022-03-28T12:11:18.5296712Z","lastUpdated": "2022-08-04T12:40:18.2641429Z","settlementObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","totalAmount": 0,"settledAmount": 0,"balanceAmount": 0,"committedAmount": 0,"uncommittedAmount": 0,"dueDate": "2023-02-05T00:00:00","expectedSettlementDate": "2023-02-05T00:00:00","originalAssetHolder": "29934986000159","originalAssetHolderDocumentType": "CNPJ","assetHolder": "29934986000159","assetHolderDocumentType": "CNPJ","obligationType": "Committed","lastUpdated": "2022-08-04T12:40:18.2363337Z","settlements": [],"contractObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","reference": "1663df5f-e400-4508-be13-19b73d1cada8","contractHolderDocumentType": "CNPJ","contractHolder": "29934986000159","effectPriority": 1,"contractType": "Warranty","warrantyType": "Fiduciary","divisionMethod": "Percentage","effectStrategy": "Specific","effectAmount": 800,"committedEffectAmount": 0,"bankAccount": {"branch": "769","account": "17266","accountDigit": "9","accountType": "CC","ispb": "00000000","documentType": "CNPJ","documentNumber": "29934986000159"},"createdAt": "2022-03-28T12:11:07.0116071Z","lastUpdated": "2022-08-04T12:40:18.2363266Z","isCanceled": false}],"financialOperationEvents":[{ "createdAt": "2020-12-05T18:28:14.2782199Z", "eventSourceReferenceKey": "57f95c79-b0d7-4f8d-9623-ed345b585800", "eventType": "Registry", "operationAmount": 1000, "operationEventType": "Creation", "processDate": "2020-12-05T18:28:14.2782223Z","processkey": "addf4ea4-341d-4cbe-a364-7b0d5b577f69"}]}]}
{"key": "5f2d553c-f501-4bec-9c3a-84a8ffc5f933","dueDate": "2023-02-25T00:00:00","paymentScheme": "ECD","debtor": "29934986000159","originalAssetHolderDocumentType": "CNPJ","originalAssetHolder": "29934986000159","amount": 0,"prePaidAmount": 0,"createdAt": "2022-03-28T12:11:18.5296712Z","lastUpdated": "2022-08-04T12:40:18.2641429Z","settlementObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","totalAmount": 0,"settledAmount": 0,"balanceAmount": 0,"committedAmount": 0,"uncommittedAmount": 0,"dueDate": "2023-02-05T00:00:00","expectedSettlementDate": "2023-02-05T00:00:00","originalAssetHolder": "29934986000159","originalAssetHolderDocumentType": "CNPJ","assetHolder": "29934986000159","assetHolderDocumentType": "CNPJ","obligationType": "Committed","lastUpdated": "2022-08-04T12:40:18.2363337Z","settlements": [],"contractObligations": [{"key": "471ee464-6781-4e34-8180-d703a96d0ece","reference": "1663df5f-e400-4508-be13-19b73d1cada8","contractHolderDocumentType": "CNPJ","contractHolder": "29934986000159","effectPriority": 1,"contractType": "Warranty","warrantyType": "Fiduciary","divisionMethod": "Percentage","effectStrategy": "Specific","effectAmount": 800,"committedEffectAmount": 0,"bankAccount": {"branch": "769","account": "17266","accountDigit": "9","accountType": "CC","ispb": "00000000","documentType": "CNPJ","documentNumber": "29934986000159"},"createdAt": "2022-03-28T12:11:07.0116071Z","lastUpdated": "2022-08-04T12:40:18.2363266Z","isCanceled": false}],"financialOperationEvents":[{ "createdAt": "2020-12-05T18:28:14.2782199Z", "eventSourceReferenceKey": "57f95c79-b0d7-4f8d-9623-ed345b585800", "eventType": "Registry", "operationAmount": 1000, "operationEventType": "Creation", "processDate": "2020-12-05T18:28:14.2782223Z","processkey": "addf4ea4-341d-4cbe-a364-7b0d5b577f69"}]}]}
Cada linha deste arquivo, corresponde a um JSON, conforme exemplo abaixo:
{
"key": "471ee464-6781-4e34-8180-d703a96d0ece",
"dueDate": "2023-02-05T00:00:00",
"paymentScheme": "ECD",
"debtor": "29934986000159",
"originalAssetHolderDocumentType": "CNPJ",
"originalAssetHolder": "29934986000159",
"amount": 0,
"prePaidAmount": 0,
"createdAt": "2022-03-28T12:11:18.5296712Z",
"lastUpdated": "2022-08-04T12:40:18.2641429Z",
"settlementObligations": [
{
"key": "471ee464-6781-4e34-8180-d703a96d0ece",
"totalAmount": 0,
"settledAmount": 0,
"balanceAmount": 0,
"committedAmount": 0,
"uncommittedAmount": 0,
"dueDate": "2023-02-05T00:00:00",
"expectedSettlementDate": "2023-02-05T00:00:00",
"originalAssetHolder": "29934986000159",
"originalAssetHolderDocumentType": "CNPJ",
"assetHolder": "29934986000159",
"assetHolderDocumentType": "CNPJ",
"obligationType": "Committed",
"lastUpdated": "2022-08-04T12:40:18.2363337Z",
"settlements": [],
"contractObligations": [
{
"key": "471ee464-6781-4e34-8180-d703a96d0ece",
"reference": "1663df5f-e400-4508-be13-19b73d1cada8",
"contractHolderDocumentType": "CNPJ",
"contractHolder": "29934986000159",
"effectPriority": 1,
"contractType": "Warranty",
"warrantyType": "Fiduciary",
"divisionMethod": "Percentage",
"effectStrategy": "Specific",
"effectAmount": 800,
"committedEffectAmount": 0,
"bankAccount": {
"branch": "769",
"account": "17266",
"accountDigit": "9",
"accountType": "CC",
"ispb": "00000000",
"documentType": "CNPJ",
"documentNumber": "29934986000159"
},
"createdAt": "2022-03-28T12:11:07.0116071Z",
"lastUpdated": "2022-08-04T12:40:18.2363266Z",
"isCanceled": false
}
],
"financialOperationEvents":[
{
"createdAt": "2020-12-05T18:28:14.2782199Z",
"eventSourceReferenceKey": "57f95c79-b0d7-4f8d-9623-ed345b585800",
"eventType": "Registry",
"operationAmount": 1000,
"operationEventType": "Creation",
"processDate": "2020-12-05T18:28:14.2782223Z",
"processkey": "addf4ea4-341d-4cbe-a364-7b0d5b577f69"
}
]
}
]
}
Passo 3 - Conciliação dos Dados Enviados e Confirmação de Conciliação
Após analisar os dados enviados e compará-los com seus dados, realizar correções de inconsistências em sua base interna ou na base da Registradora, esta última, mediante ferramentas da API de registro e operações de recebíveis listadas anteriormente.
Após as correções de inconsistências, ou em caso de não necessidade de correções, utilize o EndPoint de Confirmação da Conciliação para enviar a confirmação de finalização da Conciliação.
Caso haja problemas com a conciliação dos dados, entre em contato com nossa equipe de suporte por meio do endereço eletrônico [email protected].
