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-8c94-3293ae409c34",
"extractionReferenceDate": "2020-12-05T00:00:00",
"recipient": "88888888888888",
"recipientDocumentType": "CNPJ",
"reconciliationStatus": "pending",
"urls": [
"https://api.receivable.staging.taginfraestrutura.com.br/reconciliation/file/56614efa-5026-4c6c-93ad-3b406729effb"
],
"processKey": "1b05dee4-da0c-436f-8fc0-513ff14b4ce3",
"createdAt": "2020-12-05T23:10:15.2268055Z",
"pageSize": 100,
"currentPage": 1,
"totalElements": 1
},
"eventType": "reconciliation",
"processKey": "1b05dee4-da0c-436f-8fc0-513ff14b4ce3",
"createdAt": "2020-12-05T23:12:12.7628134Z"
}
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":"1ec6921bf7edd064a8a53d2a22ea406b","reference":"UR_002","dueDate":"2020-12-15T00:00:00Z","paymentScheme":"ACC","debtor":"31688539000109","originalAssetHolderDocumentType":"CNPJ","originalAssetHolder":"19279246000172","amount":500000,"prePaidAmount":0,"createdAt":"2020-12-07T14:24:48.797Z","lastUpdated":"2020-12-07T14:24:51.209Z","settlementObligations":[{"key":"1ec6921bf7edd064a8a53d2a22ea406b","totalAmount":500000,"settledAmount":0,"balanceAmount":500000,"committedAmount":0,"uncommittedAmount":500000,"expectedSettlementDate":"2020-12-15T00:00:00Z","assetHolder":"19279246000172","assetHolderDocumentType":"CNPJ","lastUpdated":"2020-12-09T21:47:24.3076882Z","settlements":[],"contractObligations":[],"financialOperationEvents":[{"eventType":"Registry","eventSourceReferenceKey":"4fcca647-7aee-4330-8f07-690c2bafa439","operationEventType":"Creation","operationAmount":1000,"createdDate":"2020-12-09T18:47:24.3076986Z","processKey":"42920161-f358-449d-80ba-b5fa79f7cd5f","processDate":"2020-12-09T18:47:24.3077Z"}]}]}
{"key":"7768c5ae2e09ff81309608434f87242c","reference":"UR_451","dueDate":"2025-01-27T00:00:00Z","paymentScheme":"ACC","debtor":"31688539000109","originalAssetHolderDocumentType":"CPF","originalAssetHolder":"19279246000172","amount":500000,"prePaidAmount":0,"createdAt":"2020-12-07T16:36:40.121Z","lastUpdated":"2020-12-07T16:36:43.225Z","settlementObligations":[{"key":"7768c5ae2e09ff81309608434f87242c","totalAmount":500000,"settledAmount":0,"balanceAmount":500000,"committedAmount":0,"uncommittedAmount":500000,"expectedSettlementDate":"2025-01-27T00:00:00Z","assetHolder":"19279246000172","assetHolderDocumentType":"CPF","lastUpdated":"2020-12-09T21:47:24.308808Z","settlements":[],"contractObligations":[],"financialOperationEvents":[{"eventType":"Registry","eventSourceReferenceKey":"8b4e2258-7c3b-43e5-8298-ba728a500fcf","operationEventType":"Creation","operationAmount":1000,"createdDate":"2020-12-09T18:47:24.3088118Z","processKey":"70400f2f-8ed5-461d-8019-c8e9d682495e","processDate":"2020-12-09T18:47:24.3088131Z"}]}]}
{"key":"4e07bb282fed831562064c59dfe3d416","reference":"UR_450","dueDate":"2025-01-27T00:00:00Z","paymentScheme":"CAC","debtor":"31688539000109","originalAssetHolderDocumentType":"CNPJ","originalAssetHolder":"19279246000172","amount":500000,"prePaidAmount":0,"createdAt":"2020-12-07T16:36:40.121Z","lastUpdated":"2020-12-07T16:36:43.225Z","settlementObligations":[{"key":"4e07bb282fed831562064c59dfe3d416","totalAmount":500000,"settledAmount":0,"balanceAmount":500000,"committedAmount":0,"uncommittedAmount":500000,"expectedSettlementDate":"2025-01-27T00:00:00Z","assetHolder":"19279246000172","assetHolderDocumentType":"CNPJ","lastUpdated":"2020-12-09T21:47:24.3080079Z","settlements":[],"contractObligations":[],"financialOperationEvents":[{"eventType":"Registry","eventSourceReferenceKey":"f555c2ba-1d40-4546-a8b2-572772e0c7a6","operationEventType":"Creation","operationAmount":1000,"createdDate":"2020-12-09T18:47:24.3080136Z","processKey":"58237237-7f41-4530-a0ef-680e44c9416e","processDate":"2020-12-09T18:47:24.3080159Z"}]}]}
Cada linha deste arquivo, corresponde a um JSON, conforme exemplo abaixo:
{
"key":"e4ea5f814a2fd60a3142f0f20f5c6ec5",
"reference":"UR_460",
"dueDate":"2021-01-01T00:00:00Z",
"paymentScheme":"ACC",
"debtor":"77777777777777",
"originalAssetHolderDocumentType":"CNPJ",
"originalAssetHolder":"88888888888888",
"amount":3000000,
"prePaidAmount":0,
"createdAt":"2020-12-01T17:41:29.408Z",
"lastUpdated":"2020-12-02T15:15:33.32Z",
"settlementObligations":[
{
"key":"e4ea5f814a2fd60a3142f0f20f5c6ec5",
"totalAmount":3000000,
"settledAmount":50000,
"balanceAmount":2950000,
"committedAmount":0,
"uncommittedAmount":2950000,
"expectedSettlementDate":"2021-01-01T00:00:00Z",
"assetHolderDocumentType":"CNPJ",
"assetHolder":"88888888888888",
"lastUpdated":"2020-12-05T21:28:14.2782145Z",
"settlements":[
{
"key":"a5b8ca59-0ce0-4bfe-bc8d-ac87d2883a46",
"reference":"ST-01",
"isRejected":false,
"assetHolderDocumentType":"CNPJ",
"assetHolder":"88888888888888",
"amount":50000,
"settlementDate":"2021-01-01T00:00:00Z",
"bankAccount":{
"branch":"1144",
"account":"13341",
"accountDigit":"X5",
"accountType":"CC",
"ispb":"12345678",
"documentType":"CNPJ",
"documentNumber":"99999999999999"
},
"lastUpdated":"2020-12-01T17:41:45.355Z",
}
],
"contractObligations":[
{
"key":"7013fd61-0e2e-43fe-9a73-3e08e258fa1f",
"reference":"AT_01",
"contractHolderDocumentType":"CNPJ",
"contractHolder":"72963718000194",
"effectPriority":1,
"contractType":"OwnershipAssignment",
"warrantyType":"None",
"divisionMethod":"FixedAmount",
"effectStrategy":"Specific",
"effectAmount":60000,
"committedEffectAmount":60000,
"bankAccount":{
"branch":"3232",
"account":"00121",
"accountDigit":"X3",
"accountType":"CC",
"ispb":"12100000",
"documentType":"CNPJ",
"documentNumber":"31725377000131"
},
"lastUpdated":"2020-12-05T23:34:39.0899203Z"
}
],
"financialOperationEvents":[
{
"eventType":"Registry",
"eventSourceReferenceKey":"57f95c79-b0d7-4f8d-9623-ed345b585800",
"operationEventType":"Creation",
"operationAmount":1000,
"createdAt":"2020-12-05T18:28:14.2782199Z",
"processkey":"addf4ea4-341d-4cbe-a364-7b0d5b577f69",
"processDate":"2020-12-05T18:28:14.2782223Z"
}
]
}
]
}
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].