Conciliação bancária - inncash/inncash-docs GitHub Wiki
Introdução
A concilição bancária é realizada 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
Eventos
Tranferência bancária
Enviará uma matriz com os dados de origem e destino gerados pelo Inncash.
{
"integration_id":"495cafa3-3dcb-4578-aa5c-2b50684fcd7er",
"event":"conciliation_transfer",
"id":null,
"data":{
"bank_balances":[
{
"date":"2022-01-27",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
},
{
"date":"2022-01-28",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
}
],
"movements":{
"origin":{
"date":"2021-12-21",
"amount":3494.53,
"document":null,
"document_type":"C",
"movement_type": "NF",
"bank_draft":"INN4394983",
"bank_code":"001",
"agency":"10485",
"currency_tax":null,
"account":"02145",
"nature":"54325235",
"disposition_date":"2021-12-21",
"cost_center_credit":"4242",
"cost_center_debit":"5435",
"value_class_credit":"534",
"value_class_debit":"34",
"account_item_credit":"3242",
"account_item_debit":"42",
"history":"",
"type":"P",
"branch":"01",
"prefix":"NF",
"id":"55ae2a40237f7d6995790ef0f7583ec5"
},
"destination":{
"date":"2021-12-21",
"amount":3494.53,
"document":"INN4394983",
"document_type":"C",
"movement_type": "NF",
"bank_draft":null,
"bank_code":"033",
"agency":"104553",
"currency_tax":null,
"account":"435390",
"nature":"5432232",
"disposition_date":"2021-12-21",
"cost_center_credit":"4242",
"cost_center_debit":"5435",
"value_class_credit":"534",
"value_class_debit":"34",
"account_item_credit":"3242",
"account_item_debit":"42",
"history":"",
"type":"P",
"branch":"01",
"prefix":"NF",
"id":"55ae2a40237f7d6995790ef0f7583ec5"
}
}
},
"company_id":15
}
Registro bancário
Enviará uma matriz com os dados do registro gerados pelo Inncash.
{
"integration_id":"495cafa3-3dcb-4578-aa5c-2b50684fcd7er",
"event":"conciliation_register",
"id":null,
"data":{
"bank_balances": [
{
"date": "2022-01-27",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
},
{
"date": "2022-01-28",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
}
],
"movements": {
"date":"2021-12-21",
"amount":3494.53,
"currency": "M1",
"document":"INN639502",
"document_type": "C",
"movement_type": "NF",
"bank_draft":null,
"bank_code":"001",
"agency":"10485",
"currency_tax":null,
"account":"02145",
"disposition_date":"2021-12-21",
"cost_center_credit":"4242",
"cost_center_debit":"5435",
"value_class_credit":"534",
"value_class_debit":"34",
"account_item_credit":"3242",
"account_item_debit":"42",
"nature": "54325235",
"history":"",
"type":"P",
"branch":"01",
"prefix":"NF",
"id":"55ae2a40237f7d6995790ef0f7583ec5"
}
},
"company_id":15
}
Conciliação bancária
Enviará uma matriz com os dados da conciliação gerados pelo InnCash.
{
"integration_id":"495cafa3-3dcb-4578-aa5c-2b50684fcd7er",
"event":"conciliate",
"id":null,
"data":{
"bank_balances": [
{
"date": "2022-01-27",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
},
{
"date": "2022-01-28",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
}
],
"movements": [
{
"id": "55ae2a40237f7d6995790ef0f7583ec5",
"date": "2021-12-21"
},
{
"id": "55ae2a40237f7d6995790ef0f7583ec5",
"date": "2021-12-21"
}
]
},
"company_id":15
}
Desconciliação bancária
Enviará uma matriz com os dados da desconciliação realizada pelo Inncash.
{
"integration_id":"",
"event":"delete_conciliation",
"id":null,
"data":{
"bank_balances": [
{
"date": "2022-01-27",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
},
{
"date": "2022-01-28",
"bank_id": "454545454s5d45a4sd5a4s5d45as",
"id": "2a1d2sa1d21as21d2sad1a2s"
}
],
"movements": [
{
"id": "55ae2a40237f7d6995790ef0f7583ec5"
}
]
},
"company_id":15
}
Baixa de título a receber
Enviará uma matriz com os títulos para fazer a baixa.
{
"integration_id":"495cafa3-3dcb-4578-aa5c-2b50684fcd7er",
"event":"settle_account",
"data":{
"bank_id":"454545454s5d45a4sd5a4s5d45as"
"bank":{
"code":"123",
"agency":"123",
"account":"123456"
},
"additional_information":{
"historic":"test",
"reason":"test",
"date":"2021-12-21"
},
"bank_balances":[
{
"date":"2022-01-27",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
},
{
"date":"2022-01-28",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
}
],
"receivables":[
{
"id":"123456789101112",
"tax":1,
"assessment":2.5,
"discount":10,
"received_value":14
}
],
"movements":[
{
"date":"2022-02-08",
"amount":59546787.0,
"document":null,
"bank_draft":null,
"bank_code":"iq8",
"currency_tax":null,
"currency":"01",
"agency":"1947",
"account":"12010",
"document_type":null,
"movement_type": "NF",
"disposition_date":"2022-02-08",
"cost_center_credit":null,
"cost_center_debit":null,
"value_class_credit":null,
"value_class_debit":null,
"account_item_credit":null,
"account_item_debit":null,
"history":null,
"reconciled_document":"x",
"type":"R",
"branch":"0101",
"nature":"Eaque.",
"number":"495867111",
"installment":null,
"client_code":"105212091",
"store":"0001",
"prefix":"1",
"id":"INN6d947daef7ff4e7582cfa5afb79df54b"
}
]
},
"company_id":15
}
Geração de RA vindo da conciliação bancaria
Enviará uma matriz com o título de RA que deve ser incluido no ERP.
{
"integration_id":"495cafa3-3dcb-4578-aa5c-2b50684fcd7er",
"event":"generate_advances_from_conciliation",
"id":null,
"data":{
"bank_balances":[
{
"date":"2022-01-27",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
},
{
"date":"2022-01-28",
"bank_id":"454545454s5d45a4sd5a4s5d45as",
"id":"2a1d2sa1d21as21d2sad1a2s"
}
],
"movements":{
"date":"2021-12-21",
"amount":3494.53,
"document":null,
"document_type":"C",
"movement_type": "NF",
"bank_draft":"INN4394983",
"bank_code":"001",
"agency":"10485",
"currency_tax":null,
"account":"02145",
"nature":"54325235",
"disposition_date":"2021-12-21",
"cost_center_credit":"4242",
"cost_center_debit":"5435",
"value_class_credit":"534",
"value_class_debit":"34",
"account_item_credit":"3242",
"account_item_debit":"42",
"history":"",
"type":"P",
"branch":"01",
"prefix":"NF",
"id":"55ae2a40237f7d6995790ef0f7583ec5"
},
"advance":{
"branch":"55ae2a40237f7d6995790ef0f7583ec5"
"customer_code":"3242",
"customer_store":"3242",
"title_number":"3242",
"prefix":"3242",
"balance":"3242",
"value":"3242",
"type":"3242",
"agency":"3242",
"bank":"3242",
"account":"3242",
"emission_date":"3242",
"due_date":"3242",
"actual_due_date":"3242",
"historic":"3242",
"nature":"3242",
"cost_center":"3242",
"class_value":"3242",
"accounting_item":"3242",
"installment":"3242",
"id":"3242"
}
}
},
"company_id":15
}