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
}