Skip to main content
Server path: /base-orders | Type: Application | PCID required: Yes

Tools

ToolDescription
base_orders_add_invoiceIssue an invoice for an order.
base_orders_add_orderCreate a new order in Base.
base_orders_add_order_productAdd a product to an existing order.
base_orders_add_order_returnCreate a new order return.
base_orders_delete_order_productRemove a product from an order.
base_orders_delete_ordersDelete multiple orders by their IDs.
base_orders_get_invoice_fileDownload an invoice PDF file (returned as base64-encoded content).
base_orders_get_invoicesRetrieve invoices. Returns up to 100 per call.
base_orders_get_journal_listRetrieve order event journal. Returns a log of order-related events.
base_orders_get_order_extra_fieldsRetrieve custom extra field definitions for orders.
base_orders_get_order_payments_historyRetrieve payment history for an order.
base_orders_get_order_return_reasons_listRetrieve the list of order return reasons.
base_orders_get_order_return_status_listRetrieve the list of order return statuses.
base_orders_get_order_returnsRetrieve order returns. Returns up to 100 per call.
base_orders_get_order_sourcesRetrieve the list of order sources (e.g., shop, marketplace).
base_orders_get_order_status_listRetrieve the list of order statuses.
base_orders_get_order_transaction_dataRetrieve transaction details for an order.
base_orders_get_ordersRetrieve orders from Base. Returns up to 100 orders per call.
base_orders_get_orders_by_emailSearch for orders by customer email address.
base_orders_get_orders_by_phoneSearch for orders by customer phone number.
base_orders_get_seriesRetrieve invoice/receipt numbering series.
base_orders_set_order_fieldsUpdate fields of an existing order.
base_orders_set_order_paymentRecord a payment for an order.
base_orders_set_order_product_fieldsUpdate fields of a product within an order.
base_orders_set_order_return_fieldsUpdate fields of an order return.
base_orders_set_order_return_statusChange the status of an order return.
base_orders_set_order_statusChange the status of a single order.
base_orders_set_order_statusesChange the status of multiple orders at once.

base_orders_add_invoice

Issue an invoice for an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
series_idnumberYesInvoice series identifier.

base_orders_add_order

Create a new order in Base. Parameters:
ParameterTypeRequiredDefaultDescription
order_status_idstringYesOrder status identifier.
date_addnumberNoUnix timestamp for order creation date.
currencystringNoISO 4217 currency code (e.g., USD, EUR).
emailstringYesCustomer email address.
phonestringNoCustomer phone number.
user_loginstringNoCustomer username.
user_commentsstringNoCustomer notes.
admin_commentsstringNoSeller internal notes.
payment_methodstringNoPayment method name.
payment_method_codbooleanNoCash on delivery flag.
paidbooleanNoWhether order is paid.
delivery_methodstringNoDelivery method name.
delivery_pricenumberNoShipping cost.
delivery_fullnamestringNoRecipient full name.
delivery_companystringNoRecipient company.
delivery_addressstringNoDelivery street address.
delivery_citystringNoDelivery city.
delivery_statestringNoDelivery state/province.
delivery_postcodestringNoDelivery postal code.
delivery_country_codestringNoISO country code for delivery.
invoice_fullnamestringNoInvoice recipient name.
invoice_companystringNoInvoice company name.
invoice_nipstringNoTax identification number.
invoice_addressstringNoInvoice address.
invoice_citystringNoInvoice city.
invoice_postcodestringNoInvoice postal code.
invoice_country_codestringNoInvoice country code.
want_invoicebooleanNoWhether to issue an invoice.
extra_field_1stringNoCustom extra field 1.
extra_field_2stringNoCustom extra field 2.
productsstring[]YesArray of product objects. Each should have: storage, storage_id, product_id, variant_id, name, sku, ean, price_brutto, tax_rate, quantity, weight.

base_orders_add_order_product

Add a product to an existing order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
storagestringYesStorage type (e.g., ‘db’ for catalog).
storage_idnumberNoStorage identifier.
product_idstringYesProduct identifier.
variant_idnumberNoProduct variant ID.
namestringYesProduct display name.
skustringNoStock keeping unit.
eanstringNoEuropean article number.
attributesstringNoProduct attributes string.
price_bruttonumberYesGross price.
tax_ratenumberNoTax rate percentage.
quantitynumberYesQuantity.
weightnumberNoProduct weight.

base_orders_add_order_return

Create a new order return. Parameters:
ParameterTypeRequiredDefaultDescription
order_idstringYesOriginal order identifier.
status_idstringYesReturn status identifier.
reference_numberstringNoReturn reference number.
date_addnumberNoUnix timestamp for return date.
currencystringNoISO currency code.
admin_commentsstringNoInternal notes.
emailstringNoCustomer email.
phonestringNoCustomer phone.
delivery_fullnamestringNoRecipient name.
delivery_addressstringNoReturn address.
delivery_citystringNoCity.
delivery_postcodestringNoPostal code.
delivery_country_codestringNoCountry code.
productsstring[]YesArray of returned product objects.

base_orders_delete_order_product

Remove a product from an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
order_product_idnumberYesOrder line item identifier.

base_orders_delete_orders

Delete multiple orders by their IDs. Parameters:
ParameterTypeRequiredDefaultDescription
order_idsstring[]YesArray of order IDs to delete.

base_orders_get_invoice_file

Download an invoice PDF file (returned as base64-encoded content). Parameters:
ParameterTypeRequiredDefaultDescription
invoice_idnumberYesInvoice identifier.

base_orders_get_invoices

Retrieve invoices. Returns up to 100 per call. Parameters:
ParameterTypeRequiredDefaultDescription
date_fromnumberYesUnix timestamp. Retrieve invoices created after this date.
invoice_idnumberNoRetrieve a specific invoice by ID.

base_orders_get_journal_list

Retrieve order event journal. Returns a log of order-related events. Parameters:
ParameterTypeRequiredDefaultDescription
last_log_idnumberNoLast event ID for pagination. Returns events after this ID.
logs_typesstring[]NoArray of event type IDs to filter by.

base_orders_get_order_extra_fields

Retrieve custom extra field definitions for orders.

base_orders_get_order_payments_history

Retrieve payment history for an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.

base_orders_get_order_return_reasons_list

Retrieve the list of order return reasons.

base_orders_get_order_return_status_list

Retrieve the list of order return statuses.

base_orders_get_order_returns

Retrieve order returns. Returns up to 100 per call. Parameters:
ParameterTypeRequiredDefaultDescription
date_confirmed_fromnumberYesUnix timestamp. Retrieve returns confirmed after this date.
get_unconfirmed_ordersbooleanNoInclude unconfirmed returns.

base_orders_get_order_sources

Retrieve the list of order sources (e.g., shop, marketplace).

base_orders_get_order_status_list

Retrieve the list of order statuses.

base_orders_get_order_transaction_data

Retrieve transaction details for an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.

base_orders_get_orders

Retrieve orders from Base. Returns up to 100 orders per call. Parameters:
ParameterTypeRequiredDefaultDescription
date_confirmed_fromnumberYesUnix timestamp. Retrieve orders confirmed after this date.
date_confirmed_tonumberNoUnix timestamp. Retrieve orders confirmed before this date.
order_idnumberNoRetrieve a specific order by ID.
get_unconfirmed_ordersbooleanNoInclude unconfirmed orders (default: false).
include_custom_extra_fieldsbooleanNoInclude custom extra field values.
status_idnumberNoFilter by order status ID.
filter_emailstringNoFilter orders by customer email.
filter_order_sourcestringNoFilter by order source.
filter_order_source_idnumberNoFilter by order source account ID.

base_orders_get_orders_by_email

Search for orders by customer email address. Parameters:
ParameterTypeRequiredDefaultDescription
emailstringYesCustomer email to search for.

base_orders_get_orders_by_phone

Search for orders by customer phone number. Parameters:
ParameterTypeRequiredDefaultDescription
phonestringYesCustomer phone number to search for.

base_orders_get_series

Retrieve invoice/receipt numbering series.

base_orders_set_order_fields

Update fields of an existing order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
admin_commentsstringNoSeller internal notes.
user_commentsstringNoCustomer notes.
payment_methodstringNoPayment method name.
payment_method_codbooleanNoCash on delivery flag.
delivery_methodstringNoDelivery method name.
delivery_pricenumberNoShipping cost.
delivery_fullnamestringNoRecipient full name.
delivery_companystringNoRecipient company.
delivery_addressstringNoDelivery street address.
delivery_citystringNoDelivery city.
delivery_postcodestringNoDelivery postal code.
delivery_country_codestringNoDelivery country code.
emailstringNoCustomer email.
phonestringNoCustomer phone.
extra_field_1stringNoCustom extra field 1.
extra_field_2stringNoCustom extra field 2.
custom_extra_fieldsobjectNoCustom extra fields as key-value pairs.
want_invoicebooleanNoWhether to issue an invoice.

base_orders_set_order_payment

Record a payment for an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
payment_donenumberYesAmount paid.
payment_datenumberNoUnix timestamp of payment.
payment_commentstringNoPayment notes.

base_orders_set_order_product_fields

Update fields of a product within an order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
order_product_idstringYesOrder line item identifier.
namestringNoProduct name.
skustringNoStock keeping unit.
eanstringNoEuropean article number.
attributesstringNoProduct attributes.
price_bruttonumberNoGross price.
tax_ratenumberNoTax rate.
quantitynumberNoQuantity.
weightnumberNoWeight.

base_orders_set_order_return_fields

Update fields of an order return. Parameters:
ParameterTypeRequiredDefaultDescription
return_idnumberYesReturn identifier.
admin_commentsstringNoInternal notes.
extra_field_1stringNoCustom extra field 1.
extra_field_2stringNoCustom extra field 2.
custom_extra_fieldsobjectNoCustom extra fields as key-value pairs.

base_orders_set_order_return_status

Change the status of an order return. Parameters:
ParameterTypeRequiredDefaultDescription
return_idnumberYesReturn identifier.
status_idnumberYesNew status identifier.

base_orders_set_order_status

Change the status of a single order. Parameters:
ParameterTypeRequiredDefaultDescription
order_idnumberYesOrder identifier.
status_idnumberYesNew status identifier.

base_orders_set_order_statuses

Change the status of multiple orders at once. Parameters:
ParameterTypeRequiredDefaultDescription
order_idsstring[]YesArray of order IDs.
status_idnumberYesStatus to apply to all orders.