Retornos Bancários - inncash/inncash-docs GitHub Wiki
Introdução
Os retornos bancários são processados no Inncash, porém, por preferência é possível sincronizar os dados gerados pelo sistema com a base de dados do cliente. Haverão dois eventos responsáveis pela sincronização: Webservice para teste dos Webhooks
Patch: URL_BASE/erps
Na requisição será necessário especificar o identificador da empresa por meio do "company_id" (fornecido pela Innova no momento de implantação). Ele deverá ser enviado no header da requisição com esse formato: Company-Id: 1.
Esse webservice recebe como parâmetro o mesmo corpo de requisição que será enviada ao cliente via Webhook.
O InnCash irá fazer uma requisição ao webhook cadastrado pelo cliente via POST, e para marcar a integração como sucesso deve receber um status code 200
Retornos bancários Enviará uma matriz com quinhentas posições contendo os dados gerados pelo InnCash.
O mesmo endpoint é responsável tanto pelos retornos bancários de cobrança quanto de recebimento, divergindo somente o campo title_type_record
, que fica com title_type_record = 'R' para contas a receber e title_type_record = 'P' para contas a pagar.
{
"event":"sync_bank_payback",
"integration_id": "2ef09fb5-2c09-4233-9b3d-0386f2741938",
"id":null,
"data":[
{
"id":"c51fc2eaa2591bdce2da5e023cce5d92",
"action":"4",
"bank_account":"561542",
"bank_account_digit":"443",
"settle_history": "Valor pago s /Titulo - INNCASH",
"bank_agency":"354540",
"bank_agency_digit":"854",
"bank_code":"0051",
"bank_low_reason":null,
"bank_modality":null,
"bank_occurrence":"0",
"branch":"01",
"cnab_bank_transactions_id":674,
"company":"01",
"company_token":"5e3e36aef934103164ff21847bb9a0e8",
"date_time":"2021-12-17 14:59:36",
"provider_account":"null",
"provider_account_digit":"null",
"provider_agency":"null",
"provider_agency_digit":"null",
"provider_auth":"null",
"provider_bank":"null",
"provider_barcode":"null",
"provider_name":"null",
"status":"0",
"title_customer_supplier_cgc":"null",
"title_payment_receipt_credit_date":"null",
"title_payment_receipt_customer_supplier":"12105433323",
"title_payment_receipt_customer_supplier_store":"0001",
"title_payment_receipt_discount":"0",
"title_payment_receipt_fine":"0",
"title_payment_receipt_interest":"0",
"title_payment_receipt_low_date":"null",
"title_payment_receipt_number":"000671574",
"title_payment_receipt_portion":"001",
"title_payment_receipt_prefix":"1",
"title_payment_receipt_type":"NF",
"title_payment_receipt_value":"990",
"title_payment_receive_effective_tariff":"null",
"title_payment_receive_idcnab":"0400553582535",
"title_payment_receive_net_value":"null",
"title_replaces":"1",
"title_type_record":"R"
}
],
"company_id":[15,
}
Campo | Tipo | Descrição |
---|---|---|
id | string | Identificador único da transação. |
action | string | Ação do evento (ex: "4" = liquidação). |
bank_account | string | Número da conta bancária. |
bank_account_digit | string | Dígito verificador da conta. |
settle_history | string | Histórico da liquidação. |
bank_agency | string | Agência bancária. |
bank_agency_digit | string | Dígito da agência. |
bank_code | string | Código do banco. |
bank_low_reason | string / null | Motivo da baixa, se aplicável. |
bank_modality | string / null | Modalidade bancária. |
bank_occurrence | string | Código da ocorrência no banco. |
branch | string | Código da filial da empresa. |
cnab_bank_transactions_id | Inteiro | ID da transação na base CNAB. |
company | string | Código da empresa. |
company_token | string | Token de autenticação da empresa. |
date_time | string (datetime) | Data e hora do evento. |
provider_account | string | Conta do favorecido. |
provider_account_digit | string | Dígito da conta do favorecido. |
provider_agency | string | Agência do favorecido. |
provider_agency_digit | string | Dígito da agência do favorecido. |
provider_auth | string | Código de autorização bancária. |
provider_bank | string | Banco do favorecido. |
provider_barcode | string | Código de barras do título. |
provider_name | string | Nome do favorecido. |
status | string | Status da transação (0 = pendente). |
title_customer_supplier_cgc | string | CPF/CNPJ do cliente ou fornecedor. |
title_payment_receipt_credit_date | string | Data de crédito do título. |
title_payment_receipt_customer_supplier | string | Documento do cliente/fornecedor. |
title_payment_receipt_customer_supplier_store | string | Código da loja do cliente/fornecedor. |
title_payment_receipt_discount | decimal | Valor de desconto. |
title_payment_receipt_fine | decimal | Valor de multa. |
title_payment_receipt_interest | decimal | Valor de juros. |
title_payment_receipt_low_date | string | Data de baixa do título. |
title_payment_receipt_number | string | Número do título. |
title_payment_receipt_portion | string | Parcela do título. |
title_payment_receipt_prefix | string | Prefixo identificador do título. |
title_payment_receipt_type | string | Tipo de título (ex: "NF"). |
title_payment_receipt_value | decimal | Valor original do título. |
title_payment_receive_effective_tariff | decimal | Tarifa efetiva aplicada. |
title_payment_receive_idcnab | string | Identificador CNAB da transação. |
title_payment_receive_net_value | decimal | Valor líquido recebido. |
title_replaces | string | Indica se substitui outro título. |
title_type_record | string | Tipo do título: "R" = a receber, "P" = a pagar. |