Financial documents

Endpoints

POSTGet financial documentsFinDoc.get
POSTCreate invoiceFinDoc.createIncomeFinDoc
POSTCreate expense invoiceFinDoc.createExpenseFinDoc
POSTCancellation of the financial documentFinDoc.annulFinDoc
POSTChange of descriptionFinDoc.changeDescription

Get financial documents

POST/api/RPC.common.Api.FinDoc.get?token=<TOKEN>

Key FinDoc.get · Open page

Parameters

4 body parameters inside `data[]`
Field	Type	Description
`for_date`	String	Financial document date
`from_date`	String	From date
`to_date`	String	To date
`type`	String	Financial document type

Request example

Get FinDoc By Date:
{
   "data" : [
      {
         "type" : "expense_liability",
         "for_date" : "2026-09-01"
      }
   ]
}

cURL

Get FinDoc By Date:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "type" : "expense_liability",         "for_date" : "2026-09-01"      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.get?token=<TOKEN>"

Create invoice

POST/api/RPC.common.Api.FinDoc.createIncomeFinDoc?token=<TOKEN>

Key FinDoc.createIncomeFinDoc · Open page

Parameters

32 body parameters inside `data[]`
Field	Type	Description
`id`	Integer	Financial document ID
`type`required	String	Financial document type
`for_date`	String	Financial document date
`document_date`	String	Tax date
`period`	String	Payment terms (days)
`creator`	String	Employee
`currency`	String	Currency
`num`	String	Document #
`office_name`required	String	Office name
`tax_deal_code`required	String	Tax template
`pay_type`required	String	Payment method
`advance`	Boolean	Advance Invoice
`partner`required	Object	Partner object.
`partner.id`	String	Customer ID
`partner.is_company`	Boolean	Customer is a company
`partner.client_type`	String	Customer type
`partner.name`required	String	Name
`partner.eik`	String	UIC
`partner.egn`	String	ID
`partner.dds_num`	String	VAT Number
`partner.email`	String	E-mail
`partner.phone`	String	Phone
`rows`required	Object	Rows object.
`rows.sku`required	String	Item SKU
`rows.sku`required	String	Service ID
`rows.allocation_name`	String	Revenue category
`rows.tax_instance_name`	String	Tax Rate
`rows.quantity`required	String	Quantity
`rows.measure_code`	String	Unit of measurement ID
`rows.price`required	String	Unit price
`rows.description`	String	Description
`rows.discount`	String	Discount %

Request example

Create Income Invoice:
{
   "data" : [
      {
         "type" : "liability",
         "tax_deal_code" : 6,
         "partner" : {
            "mail" : "medmag@medmagbg.com",
            "is_company" : 1,
            "eik" : 203982121,
            "name" : "MEDMAC"
         },
         "pay_type" : "rev",
         "office_name" : "WholeSales",
         "rows" : [
            {
               "quantity" : 3,
               "price" : "54.00",
               "sku" : 777970
            },
            {
               "quantity" : 4,
               "price" : "78.00",
               "sku" : 10156
            },
            {
               "sku" : 98765432,
               "quantity" : 1,
               "price" : "38.00"
            }
         ]
      }
   ]
}

cURL

Create Income Invoice:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "type" : "liability",         "tax_deal_code" : 6,         "partner" : {            "mail" : "medmag@medmagbg.com",            "is_company" : 1,            "eik" : 203982121,            "name" : "MEDMAC"         },         "pay_type" : "rev",         "office_name" : "WholeSales",         "rows" : [            {               "quantity" : 3,               "price" : "54.00",               "sku" : 777970            },            {               "quantity" : 4,               "price" : "78.00",               "sku" : 10156            },            {               "sku" : 98765432,               "quantity" : 1,               "price" : "38.00"            }         ]      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.createIncomeFinDoc?token=<TOKEN>"

Create expense invoice

POST/api/RPC.common.Api.FinDoc.createExpenseFinDoc?token=<TOKEN>

Key FinDoc.createExpenseFinDoc · Open page

Parameters

32 body parameters inside `data[]`
Field	Type	Description
`id`	Integer	Financial document ID
`type`required	String	Financial document type
`for_date`	String	Financial document date
`document_date`	String	Tax date
`end_date`	String	Payment terms (days)
`creator`	String	Employee
`currency`	String	Currency
`num`required	String	Document #
`office_name`required	String	Office name
`tax_deal_code`required	String	Tax template
`pay_type`required	String	Payment method
`advance`	Boolean	Advance Invoice
`partner`required	Object	Partner object.
`partner.id`	String	Customer ID
`partner.is_company`	Boolean	Customer is a company
`partner.client_type`	String	Customer type
`partner.name`required	String	Name
`partner.eik`	String	UIC
`partner.egn`	String	ID
`partner.dds_num`	String	VAT Number
`partner.email`	String	E-mail
`partner.phone`	String	Phone
`rows`required	Object	Rows object.
`rows.sku`required	String	Item SKU
`rows.sku`required	String	Service ID
`rows.allocation_name`	String	Expense category
`rows.tax_instance_name`	String	Tax Rate
`rows.quantity`required	String	Quantity
`rows.measure_code`	String	Unit of measurement ID
`rows.price`required	String	Unit price
`rows.description`	String	Description
`rows.discount`	String	Discount %

Request example

Create Expense Invoice:
{
   "data" : [
      {
         "office_name" : "Online Sales",
         "num" : "0000000046",
         "rows" : [
            {
               "sku" : 10007,
               "quantity" : 5,
               "price" : "41.00"
            }
         ],
         "partner" : {
            "is_company" : 1,
            "eik" : 103676134,
            "name" : "ELBA LTD"
         },
         "pay_type" : "015",
         "type" : "expense_invoice",
         "tax_deal_code" : 4
      }
   ]
}

cURL

Create Expense Invoice:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "office_name" : "Online Sales",         "num" : "0000000046",         "rows" : [            {               "sku" : 10007,               "quantity" : 5,               "price" : "41.00"            }         ],         "partner" : {            "is_company" : 1,            "eik" : 103676134,            "name" : "ELBA LTD"         },         "pay_type" : "015",         "type" : "expense_invoice",         "tax_deal_code" : 4      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.createExpenseFinDoc?token=<TOKEN>"

Cancellation of the financial document

POST/api/RPC.common.Api.FinDoc.annulFinDoc?token=<TOKEN>

Key FinDoc.annulFinDoc · Open page

Parameters

2 body parameters inside `data[]`
Field	Type	Description
`num`	String	Document #
`annul_description`	String	Description of cancelation

Request example

Annul Invoice:
{
   "data" : [
      {
         "annul_description" : "Test for Annul Invoice 9087979087908",
         "num" : 9087979087908
      }
   ]
}

cURL

Annul Invoice:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "annul_description" : "Test for Annul Invoice 9087979087908",         "num" : 9087979087908      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.annulFinDoc?token=<TOKEN>"

Change of description

POST/api/RPC.common.Api.FinDoc.changeDescription?token=<TOKEN>

Key FinDoc.changeDescription · Open page

Parameters

4 body parameters inside `data[]`
Field	Type	Description
`id`	Integer	Financial document ID
`num`required	String	Document #
`description`required	String	Description
`internal_description`required	String	Internal description

Request example

Change Description By Num:
{
   "data" : [
      {
         "num" : "0000000001",
         "description" : "Lorem Ipsum Description",
         "internal_description" : "Lorem Ipsum Internal Description"
      }
   ]
}
Change Description By Id:
{
   "data" : [
      {
         "id" : 3225622,
         "description" : "Lorem Ipsum Description",
         "internal_description" : "Lorem Ipsum Internal Description"
      }
   ]
}

cURL

Change Description By Num:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "num" : "0000000001",         "description" : "Lorem Ipsum Description",         "internal_description" : "Lorem Ipsum Internal Description"      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.changeDescription?token=<TOKEN>"
Change Description By Id:
curl -X POST -H 'Content-Type: application/json; charset=utf-8' -d '{   "data" : [      {         "id" : 3225622,         "description" : "Lorem Ipsum Description",         "internal_description" : "Lorem Ipsum Internal Description"      }   ]}' "https://<DOMAIN_NAME>/api/RPC.common.Api.FinDoc.changeDescription?token=<TOKEN>"

Response example

    HTTP/1.1 200 OK
{
   "result" : [
      {
         "for_date" : "2020-10-06",
         "id" : 3225622,
         "pos_name" : "",
         "num" : "0000000001",
         "updatedon" : "2026-01-01 09:22:28",
         "type_action" : "invoice",
         "createdon" : "2021-10-06 14:40:20",
         "description" : null,
         "internal_description" : null,
         "type" : "invoice",
         "for_date_formated" : "06.10.2020",
         "rel_trans" : [
            {
               "trans_id" : 3225622,
               "num" : null,
               "for_date" : "2020-10-06",
               "rel_trans_id" : 3225628,
               "type" : "bank_income"
            },
            {
               "rel_trans_id" : 3225607,
               "for_date" : "2020-10-06",
               "type" : "so",
               "trans_id" : 3225622,
               "num" : "CO10000001"
            }
         ]
      }
   ]
}