Visão Geral

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

347347

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

496496

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].