Após o processamento das transações é possível consultar o resultado das pendências e transações conciliadas.
Através de um requestId é possível identificar as transações processadas. Segue abaixo uma demonstração do resultado do processamento:
{
"total": 2,
"errors": 1,
"processed": 1,
"results":[
{
"id":"4566384#0101",
"row_id":123456, // ID interno do processo de conciliação
"msg": None // Processado
},
{
"id":"9826837#0101",
"row_id":"",
"msg":"Lançamento já reconciliado." // Lançamento já conciliado anteriormente
}
]
}
As mensagens de erros são genéricas. As possibilidades são Lançamento já conciliado anteriormente (vendas que já estavam conciliadas), Erro ao inserir lançamento ou ID da venda não encontrado (para solicitação de deleção de vendas).
Para identificar transações conciliadas, os campos "id" e "status" estarão preenchidos de acordo com o exemplo abaixo:
"meta":{...},
"results":[
{
"source":"acquirer", // Origem
"id":"4566384", // ID da venda preenchido
"branch":"CONCIL_FILIAL_SP",
"merchant":"9912101714",
"installmentIndex":1,
"installmentCount":1,
"installmentAmount":25.5,
"acquirerId":5,
"brandId":1,
"productId":1,
"nsu":"0026671158",
"authorization":"091070",
"expectedClearingDate":"20200401",
"saleDate":"20200301",
"grossAmount":25.5,
"netAmount":24.99,
"administrationFee":1.99,
"status":"CONCILIADO", // Status conciliado
"bankCode":"001",
"bankAgency":"9601",
"bankAccount":"100991",
"tid":"10605426468169",
"captureChannel":"POS",
"terminal":"",
"cardNumber":"875389******1229",
"transactionType":"",
"classification":"",
"discount":"",
"invoice":"",
"conciliationId":"6745762344",
"pfj":"1.1.1"
}
]
Quando não for possível realizar a conciliação das transações, elas serão separadas em duas origens:
acquirer
Transações com status "PENDENTE" e origem "acquirer" são de origem da adquirente.
client
Os status "PENDENTE" e origem "client" são transações de origem do cliente.
Ambos lançamentos serão retornados na requisição para identificar o motivo da pendência. Essas pendências devem ser corrigidas e reenviadas pela API novamente para que a conciliação tenha sucesso. No exemplo abaixo simulamos o valor incorreto:
{
"meta":{...},
"results":[
{
"source":"client", // Origem cliente
"id":"9826837", // CHAVE/ID Cliente
"branch":"CONCIL_FILIAL_RJ",
"merchant":"9912101714",
"installmentIndex":1,
"installmentCount":1,
"installmentAmount": 15.99, // Simulamos o valor divergente
"acquirerId":5,
"brandId":1,
"productId":1,
"nsu":"0026671158",
"authorization":"091070",
"expectedClearingDate":"20200401",
"saleDate":"20200301",
"grossAmount":15.99,
"netAmount":15.99,
"administrationFee":0,
"status":"PENDENTE",
"bankCode":"001",
"bankAgency":"9601",
"bankAccount":"100991",
"tid":"10705426869821",
"captureChannel":"POS",
"terminal":"",
"cardNumber":"651087******9123",
"transactionType":"",
"classification":"",
"discount":"",
"invoice":"",
"conciliationId":"",
"pfj":"1.1.1"
},
{
"source":"acquirer", // Origem adquirente
"id": null, // Sem código porque não conciliou
"branch":"CONCIL_FILIAL_RJ",
"merchant":"9912101714",
"installmentIndex":1,
"installmentCount":1,
"installmentAmount":9.99, // Simulamos o valor divergente
"acquirerId":5,
"brandId":1,
"productId":1,
"nsu":"0026671158",
"authorization":"091070",
"expectedClearingDate":"20200401",
"saleDate":"20200301",
"grossAmount":9.99,
"netAmount":9.79,
"administrationFee":1.99,
"status":"PENDENTE", // status pendente
"bankCode":"001",
"bankAgency":"9601",
"bankAccount":"100991",
"tid":"10705426869821",
"captureChannel":"POS",
"terminal":"",
"cardNumber":"651087******9123",
"transactionType":"",
"classification":"",
"discount":"",
"invoice":"",
"conciliationId":"",
"pfj":"1.1.1"
}
]
}
Motivos de pendências de venda
Os motivos de pendências podem variar e ainda não é possível determinar com precisão todos cenários possíveis. A maior parte deles tem origem no registro da venda pelo estabelecimento e para evitar pendências, certifique-se de enviar as transações corretas, com máximo de detalhes possíveis, sempre consultando seus retornos com prazo recomendado de D-2.