BillingDocs
Functions
Arguments
| type |
alpha_dash, required |
Arguments
(also
Data Table args)
| q |
string |
| client_id |
integer (incl. search params) |
| client_number |
string |
| delivery_note_attached |
string |
| date |
date (incl. search params) |
| time |
date (incl. search params) |
| nr |
string |
| type |
in: D, C, O, K, S, F, R, P, all |
| status |
string |
| description |
string |
| bill_text |
string |
| payment_type |
string |
| currency |
string |
| net_amount |
float (incl. search params) |
| gross_amount |
float (incl. search params) |
| total_amount |
float (incl. search params) |
| payment_type_discount |
float (incl. search params) |
| payment_type_discount_percentage |
float (incl. search params) |
| vat_amount |
float (incl. search params) |
| payment_date |
date (incl. search params) |
| delivery_date |
string |
| due_date |
string |
| dd_list_date |
date (incl. search params) |
| order_nr |
integer (incl. search params) |
| batch_date |
date (incl. search params) |
| lastname |
string |
| firstname |
string |
| email |
string |
| company |
string |
| country |
string |
| language |
string |
| city |
string |
| zip |
string |
| is_final |
string |
| filter_data |
string |
| groups |
string |
| groups_excluded |
string |
| groups_restricted |
string |
| saveByFilterName |
string |
| iNewFilterCategory |
string |
| saveByFilterId |
integer |
| sSaveFilterData |
string |
| requestStoredFilter |
in: 0, 1 |
| filter_category_id |
integer (incl. search params) |
| currentFilterId |
string |
| columnManager |
string |
| createtime |
string |
| ts |
string |
| addressextension1 |
string |
| addressextension2 |
string |
Get bill including all its details
like list of articles
Arguments
Create an empty bill
This is required before adding any items to the bill
@param: currency (3 char currency code (TODO:// default should be the company's primary currency))
@param: type (singe char code that defines the type of the bill: default D)
@param: payment_type ( INVOICE | SEPA | PAYPAL etc: default: INVOICE)
Arguments
| client_id |
integer, required |
| currency |
string |
| type |
string |
| payment_type |
string |
| delivery_date |
date |
| due_date |
date |
| delivery_address_id |
integer |
| billing_address_id |
integer |
| template_id |
integer |
Alias of the create function
Arguments
| client_id |
numeric, required |
| type |
required, in: D, C, O, K, S, F, R, P, all |
| currency |
string |
| status |
in: OPEN, PAID, PARTIAL_PAID, CANCELLED, REMINDED, ACCEPTED |
| date |
date |
| payment_type |
string |
| due_date |
date |
| delivery_date |
date |
| description |
string |
| delivery_address_id |
integer |
| shipping_id |
integer |
| delivery_type |
in: partial_delivery, total_delivery |
| billing_address_id |
integer |
| template_id |
numeric |
Set a multiple bills as paid
@params ids is a comma separated list of bill ids Ex. 581,1104,1103
Arguments
Add an item to a bill
Arguments
| bill_id |
integer, required |
| article_id |
integer, required |
| qty |
float |
| price |
numeric |
| vat_percent |
float |
| tax_included |
integer |
| name |
string |
Update an item from a bill
Note: Updates cannot happen once the bill is finalized
Arguments
| bill_id |
integer, required |
| article_id |
integer, required |
| booked_article_id |
integer, required |
| price |
numeric |
| vat_percent |
float |
| qty |
float |
| tax_included |
integer |
| name |
string |
Delete an item from a bill
Note: Items cannot be deleted once the bill is finalized
Arguments
| bill_id |
integer, required |
| booked_article_id |
integer, required |
Finalize the bill
This action will lock the bill for changes, will create a PDF and send notifications if necessary
Arguments
Validate alpha string part and start numbers
@params
Arguments
| company_id |
numeric, required |
| numbers |
array, required |
Set a single bill as paid
@params id is the bill id
Arguments
| id |
integer, required |
| payment_date |
date |
| paid_amount |
float |
| status |
in: PAID, PARTIAL_PAID |
Set a single bill as canceled
@params id is the bill id
Arguments
Set a single bill as unpaid
@params id is the bill id
Arguments
Creates a delivery note from one invoice
@param id is the bill id
@param address_id is optional. If this is set, a different shipping address will be used. address_id is the id of the supplementary address.
If this parameter is omited, the shiping address will be the same as the default client address
@param delivery_date - optional, set another delivery date. Format: YYYY-MM-DD
Arguments
| id |
integer, required |
| address_id |
integer |
| delivery_date |
string |
Notify one or more bills by email
@param required: bill_ids (ids of the bills, comma separated)
Arguments
Create reminders
@param required: bill_ids (ids of the bills, comma separated)
@param reminder_settings_id - id of reminder template to be used
Arguments
| bill_ids |
ids, required |
| reminder_settings_id |
integer, required |
Send reminders
@param required: bill_ids (ids of the bills, comma separated)
@param reminder_settings_id - id of reminder template to be used
Arguments
| bill_ids |
ids, required |
| reminder_settings_id |
integer, required |
Regenerate PDF of a bill
@param required: id (id of the bill to be regenerated)
Arguments
Process of generating Unbilled Invoices
This finalizes bills for all bills that have boookings and were not yet finalized
The clients are informed about the bill generation by email if the option is checked
After finalizing the bills the process creates a merged PDF document. The user who initiated the tasks is informed by company message
The company also gets a notification by email if that option is checked
@paramoptional: email_client [ 0 or 1 ] default 0
@paramoptional: email_company [ 0 or 1 ] default 0
@return Value: Array (task which will be executed)
Arguments
| email_client |
in: 0, 1 |
| email_company |
in: 0, 1 |
| email_affiliate |
in: 0, 1 |
| generation_start_time |
string, required |
| document_type |
string, required |
| minimum_amount |
string |
retrieveGeneratedInvoices
Get generated invoices if automatic process is completed
@param generation_start_time: start time saved in AutomaticProcess table
@return Value: Array generated invoices
Arguments
| generation_start_time |
string, required |
| document_type |
string, required |
Process of generating Print Invoices
This creates a merged PDF document for all bills that have not been printed. The user who initiated the tasks is informed by company message
@paramoptional: email_company [ 0 or 1 ] default 0
The company also gets a notification by email if that option is checked
@return Value: Array (task which will be executed)
Arguments
Arguments
| billId |
string, required |
| customerId |
string, required |
| newBillType |
string, required |
| fromType |
string, required |
| template_id |
string |
createMultipleFromExisting
Arguments
| bill_ids |
ids, required |
| newBillType |
string, required |
| template_id |
string |
Arguments
| bill_ids |
ids, required |
| company_id |
integer, required |
getStandardContractsWithTranslations
Arguments
| id |
ids, required |
| currentUserLang |
string |
getStandardContractsViewPdf
Arguments
| id |
string, required |
| lang |
string |
Arguments
| id |
string |
| name |
string, required |
| type |
required, string, in: standardformcontract, revocation |
| data |
string, required |
recalculateEmptyDocumentsAmounts
Arguments
| dataTableMethod |
string, required |
| sDatatableKey |
string |
calculatePaymentMethodPrice
Arguments
| articles_ids |
required, json |
| payment_method |
string |
| client_id |
string |
| shipping_method |
string |
| delivery_address_id |
string |
| add_payment_item |
boolean |
| add_shipping_item |
boolean |
Arguments
| ids |
ids, required |
| document_type |
string |
Arguments
| ids |
ids, required |
| status |
in: OPEN, PAID, CANCELLED, ACCEPTED, required |
Arguments
| id |
numeric, required |
| write |
boolean |
Get one record based on id
Arguments
Edit one record
Arguments
| id |
integer, required |
| client_id |
numeric |
| type |
in: D, C, O, K, S, F, R, P, all |
| currency |
string |
| status |
in: OPEN, PAID, PARTIAL_PAID, CANCELLED, REMINDED, ACCEPTED |
| date |
date |
| due_date |
date |
| delivery_date |
date |
| template_id |
integer |
| payment_type |
string |
| bill_text |
string |
| description |
string |
| delivery_address_id |
integer |
| shipping_id |
integer |
| delivery_type |
in: partial_delivery, total_delivery |
| billing_address_id |
integer |
| add_payment_item |
boolean |
| add_shipping_item |
boolean |
Delete one record
Arguments
| id |
integer, required |
| confirmed |
boolean |
Get Change Log for an object
Arguments