API de Conciliação

O relatório de Conciliação poderá ser solictado pela API abaixo e estará disponível no bucket de cada participante. Para que você tenha acesso, entre em contato com o time de Operações para que eles possam cadastrar essa interface.

O relatório ficará disponível na pasta: duplicatas/conciliacao/saida/yyyy/MM/dd com a seguinte nomenclatura: CERC-DPL011_(cnpj-base)(AAMMDD)(SEQ).csv

A geração ocorre diariamente à 00h. No caso da geração pontual, o processamento levará cerca de 3 min para gerar um relatório de 100 duplicatas.

Segue o layout do arquivo:

PreviousBusca de Cancelamentos de Registro NextAPI Webhook

Last updated 5 months ago

Busca de conciliações de Duplicatas pelo financiador

Este endpoint busca conciliações de Duplicatas pelo financiador com base no filtro fornecido

get

/v1/conciliations

Query parameters

participantDocumentstringrequired

CNPJ do financiador

Example: 00000000000000

referenceDateListstringrequired

Lista de datas separada por ponto e vírgula

Example: 2024-08-01;2024-08-01

walletstring

Código da carteira

Example: codigoDaCarteira

statusstring

Status da conciliação que pode ser CONCILIADO ou PENDENTE

Example: CONCILIADO

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations?participantDocument=text&referenceDateList=text'

200

[
  {
    "referenceDate": "text",
    "status": {
      "id": "text",
      "description": "text"
    },
    "invoices": {
      "walletCount": 1,
      "stockCount": 1,
      "stockValue": 1
    },
    "conciliationData": [
      {
        "id": "text",
        "calculationDate": "text",
        "creationDate": "text",
        "processingDate": "text",
        "wallet": "text",
        "serviceInvoiceCount": "text",
        "mercantileInvoiceCount": "text",
        "serviceInvoiceTotal": "text",
        "mercantileInvoiceTotal": "text",
        "contractCountTotal": "text",
        "contractValueTotal": "text",
        "status": "text",
        "conciliationUser": {
          "name": "text",
          "companyDocument": "text",
          "userDocumentNumber": "text"
        }
      }
    ]
  }
]

Realiza a conciliação de Duplicatas do financiador com base no filtro fornecido

Realiza a conciliação de Duplicatas do financiador

put

/v1/conciliations

Body

cnpjFinanciadorstringrequired

walletsForConciliatedobject[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request PUT \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations' \
  --header 'Content-Type: application/json' \
  --data '{"participantDocument":"12345678912345","walletsToConciliate":[{"referenceDate":"2024-08-11","walletList":["carteira1","carteira2"]}]}'

200

403

404

{
  "message": "Carteiras conciliadas com sucesso!",
  "walletsConciliated": [
    {
      "referenceDate": "2024-09-06",
      "walletList": [
        "carteira_1"
      ]
    }
  ]
}

Retorno de sucesso

Relatorio de conciliacao

Este endpoint busca as solicitacoes de relatorio de conciliacao do participante

get

/v1/conciliations/report

Query parameters

operationIdstring · uuid

Id da operação

Example: 2bc349a8-d215-44d0-b895-beb51bf277a9

participantDocumentstring

CNPJ do participante

Example: 00000000000000

requesterstring

CNPJ do solicitante

Example: 00000000000000

statusstring

status

Example: PENDING ou COMPLETED

externalReferencestring

Referência Externa

Example: referencia_externa

startDatestring

Data de Inicio

Example: 2024-07-28

endDatestring

Data Fim

Example: 2024-07-29

traceIdstring

Id de Rastreamento

Example: 6a3329a1-d715-44d0-b895-beb51bf850b1

pageinteger · int32

Número da página

Example: 0

linePerPageinteger · int32 · default: 10

Total de dados por página

Example: 10

orderstring · default: requestDate

Campo referência para ordenação

Example: requestDate

directionstring · default: ASC

Forma de ordenação (ASC ou DESC)

Example: ASC

Responses

*/*

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations/report'

200

{
  "totalPages": 1,
  "totalElements": 1,
  "numberOfElements": 1,
  "size": 1,
  "number": 1,
  "first": true,
  "last": true,
  "empty": true,
  "sort": {
    "empty": true,
    "sorted": true,
    "unsorted": true
  },
  "content": [
    {
      "id": "text",
      "participantDocument": "text",
      "requester": "text",
      "externalReference": "text",
      "operationId": "text",
      "statusReport": "text",
      "completionDate": "text",
      "requestDate": "text"
    }
  ],
  "pageable": {
    "offset": 1,
    "pageSize": 1,
    "pageNumber": 1,
    "paged": true,
    "unpaged": true,
    "sort": {
      "empty": true,
      "sorted": true,
      "unsorted": true
    }
  }
}

Relatório de conciliação

Este endpoint faz a solicitação do relatório de conciliação

post

/v1/conciliations/report

Body

participantDocumentstringrequired

externalReferencestring · max: 1000required

walletListstring[]required

referenceDateListstring[]required

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations/report' \
  --header 'Content-Type: application/json' \
  --data '{"participantDocument":"00000000000000","externalReference":"referencia_externa","walletList":["carteira1","carteira2"],"referenceDateList":["2024-08-17","2024-08-12","2024-08-18"]}'

200

400

{
  "id": "cde239e3-2cd9-4521-831e-1caf1da5b2de",
  "message": "Relatório solicitado com sucesso"
}

Retorno de sucesso

Relatório de conciliação

Este endpoint busca uma solicitação pelo id da operação

get

/v1/conciliations/report/{id}

Path parameters

idstring · uuidrequired

Id do relatório gerado após a solicitação (UUID)

Example: abc12345-d215-44d0-b895-beb51bf277a0

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations/report/{id}'

200

404

{
  "id": "abc12345-d215-44d0-b895-beb51bf277a0",
  "externalReference": "20240818_teste",
  "operationId": "b15ada7a-e154-432b-15dc-43c2595237c2",
  "statusReport": "COMPLETED",
  "completionDate": "2024-08-21",
  "requestDate": "2024-08-21 15:23:57.703606",
  "participantDocument": "12345667000118",
  "requester": "12345667000118"
}

Relatório encontrado

Busca o status dos dias do mês das conciliações de duplicatas do financiador

Este endpoint busca o status dos dias com base no ano-mês e documento do participante fornecidos

get

/v1/conciliations/periods

Query parameters

requestMonthstringrequired

Ano e mês para buscar dias pendentes

Example: 2024-08

participantDocumentstringrequired

CNPJ do financiador

Example: 00000000000000

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://api.stg.cerc.com/publisher/electronic-invoice/v1/conciliations/periods?requestMonth=text&participantDocument=text'

200

403

[
  {
    "referenceDate": "2024-08-01",
    "pendingItemCount": "1",
    "conciliatedItemCount": "16",
    "totalItemCount": "16",
    "status": "CONCILIADO",
    "walletList": [
      "carteira_1",
      "carteira_2",
      "carteira_3"
    ]
  }
]

Retorno de sucesso