/base-orders | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
base_orders_add_invoice | Issue an invoice for an order. |
base_orders_add_order | Create a new order in Base. |
base_orders_add_order_product | Add a product to an existing order. |
base_orders_add_order_return | Create a new order return. |
base_orders_delete_order_product | Remove a product from an order. |
base_orders_delete_orders | Delete multiple orders by their IDs. |
base_orders_get_invoice_file | Download an invoice PDF file (returned as base64-encoded content). |
base_orders_get_invoices | Retrieve invoices. Returns up to 100 per call. |
base_orders_get_journal_list | Retrieve order event journal. Returns a log of order-related events. |
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. |
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. |
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. |
base_orders_get_orders | Retrieve orders from Base. Returns up to 100 orders per call. |
base_orders_get_orders_by_email | Search for orders by customer email address. |
base_orders_get_orders_by_phone | Search for orders by customer phone number. |
base_orders_get_series | Retrieve invoice/receipt numbering series. |
base_orders_set_order_fields | Update fields of an existing order. |
base_orders_set_order_payment | Record a payment for an order. |
base_orders_set_order_product_fields | Update fields of a product within an order. |
base_orders_set_order_return_fields | Update fields of an order return. |
base_orders_set_order_return_status | Change the status of an order return. |
base_orders_set_order_status | Change the status of a single order. |
base_orders_set_order_statuses | Change the status of multiple orders at once. |
base_orders_add_invoice
Issue an invoice for an order. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
series_id | number | Yes | — | Invoice series identifier. |
base_orders_add_order
Create a new order in Base. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_status_id | string | Yes | — | Order status identifier. |
date_add | number | No | — | Unix timestamp for order creation date. |
currency | string | No | — | ISO 4217 currency code (e.g., USD, EUR). |
email | string | Yes | — | Customer email address. |
phone | string | No | — | Customer phone number. |
user_login | string | No | — | Customer username. |
user_comments | string | No | — | Customer notes. |
admin_comments | string | No | — | Seller internal notes. |
payment_method | string | No | — | Payment method name. |
payment_method_cod | boolean | No | — | Cash on delivery flag. |
paid | boolean | No | — | Whether order is paid. |
delivery_method | string | No | — | Delivery method name. |
delivery_price | number | No | — | Shipping cost. |
delivery_fullname | string | No | — | Recipient full name. |
delivery_company | string | No | — | Recipient company. |
delivery_address | string | No | — | Delivery street address. |
delivery_city | string | No | — | Delivery city. |
delivery_state | string | No | — | Delivery state/province. |
delivery_postcode | string | No | — | Delivery postal code. |
delivery_country_code | string | No | — | ISO country code for delivery. |
invoice_fullname | string | No | — | Invoice recipient name. |
invoice_company | string | No | — | Invoice company name. |
invoice_nip | string | No | — | Tax identification number. |
invoice_address | string | No | — | Invoice address. |
invoice_city | string | No | — | Invoice city. |
invoice_postcode | string | No | — | Invoice postal code. |
invoice_country_code | string | No | — | Invoice country code. |
want_invoice | boolean | No | — | Whether to issue an invoice. |
extra_field_1 | string | No | — | Custom extra field 1. |
extra_field_2 | string | No | — | Custom extra field 2. |
products | string[] | Yes | — | Array 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
storage | string | Yes | — | Storage type (e.g., ‘db’ for catalog). |
storage_id | number | No | — | Storage identifier. |
product_id | string | Yes | — | Product identifier. |
variant_id | number | No | — | Product variant ID. |
name | string | Yes | — | Product display name. |
sku | string | No | — | Stock keeping unit. |
ean | string | No | — | European article number. |
attributes | string | No | — | Product attributes string. |
price_brutto | number | Yes | — | Gross price. |
tax_rate | number | No | — | Tax rate percentage. |
quantity | number | Yes | — | Quantity. |
weight | number | No | — | Product weight. |
base_orders_add_order_return
Create a new order return. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | string | Yes | — | Original order identifier. |
status_id | string | Yes | — | Return status identifier. |
reference_number | string | No | — | Return reference number. |
date_add | number | No | — | Unix timestamp for return date. |
currency | string | No | — | ISO currency code. |
admin_comments | string | No | — | Internal notes. |
email | string | No | — | Customer email. |
phone | string | No | — | Customer phone. |
delivery_fullname | string | No | — | Recipient name. |
delivery_address | string | No | — | Return address. |
delivery_city | string | No | — | City. |
delivery_postcode | string | No | — | Postal code. |
delivery_country_code | string | No | — | Country code. |
products | string[] | Yes | — | Array of returned product objects. |
base_orders_delete_order_product
Remove a product from an order. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
order_product_id | number | Yes | — | Order line item identifier. |
base_orders_delete_orders
Delete multiple orders by their IDs. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_ids | string[] | Yes | — | Array of order IDs to delete. |
base_orders_get_invoice_file
Download an invoice PDF file (returned as base64-encoded content). Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
invoice_id | number | Yes | — | Invoice identifier. |
base_orders_get_invoices
Retrieve invoices. Returns up to 100 per call. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
date_from | number | Yes | — | Unix timestamp. Retrieve invoices created after this date. |
invoice_id | number | No | — | Retrieve a specific invoice by ID. |
base_orders_get_journal_list
Retrieve order event journal. Returns a log of order-related events. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
last_log_id | number | No | — | Last event ID for pagination. Returns events after this ID. |
logs_types | string[] | No | — | Array 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
date_confirmed_from | number | Yes | — | Unix timestamp. Retrieve returns confirmed after this date. |
get_unconfirmed_orders | boolean | No | — | Include 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
base_orders_get_orders
Retrieve orders from Base. Returns up to 100 orders per call. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
date_confirmed_from | number | Yes | — | Unix timestamp. Retrieve orders confirmed after this date. |
date_confirmed_to | number | No | — | Unix timestamp. Retrieve orders confirmed before this date. |
order_id | number | No | — | Retrieve a specific order by ID. |
get_unconfirmed_orders | boolean | No | — | Include unconfirmed orders (default: false). |
include_custom_extra_fields | boolean | No | — | Include custom extra field values. |
status_id | number | No | — | Filter by order status ID. |
filter_email | string | No | — | Filter orders by customer email. |
filter_order_source | string | No | — | Filter by order source. |
filter_order_source_id | number | No | — | Filter by order source account ID. |
base_orders_get_orders_by_email
Search for orders by customer email address. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
email | string | Yes | — | Customer email to search for. |
base_orders_get_orders_by_phone
Search for orders by customer phone number. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
phone | string | Yes | — | Customer 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
admin_comments | string | No | — | Seller internal notes. |
user_comments | string | No | — | Customer notes. |
payment_method | string | No | — | Payment method name. |
payment_method_cod | boolean | No | — | Cash on delivery flag. |
delivery_method | string | No | — | Delivery method name. |
delivery_price | number | No | — | Shipping cost. |
delivery_fullname | string | No | — | Recipient full name. |
delivery_company | string | No | — | Recipient company. |
delivery_address | string | No | — | Delivery street address. |
delivery_city | string | No | — | Delivery city. |
delivery_postcode | string | No | — | Delivery postal code. |
delivery_country_code | string | No | — | Delivery country code. |
email | string | No | — | Customer email. |
phone | string | No | — | Customer phone. |
extra_field_1 | string | No | — | Custom extra field 1. |
extra_field_2 | string | No | — | Custom extra field 2. |
custom_extra_fields | object | No | — | Custom extra fields as key-value pairs. |
want_invoice | boolean | No | — | Whether to issue an invoice. |
base_orders_set_order_payment
Record a payment for an order. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
payment_done | number | Yes | — | Amount paid. |
payment_date | number | No | — | Unix timestamp of payment. |
payment_comment | string | No | — | Payment notes. |
base_orders_set_order_product_fields
Update fields of a product within an order. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
order_product_id | string | Yes | — | Order line item identifier. |
name | string | No | — | Product name. |
sku | string | No | — | Stock keeping unit. |
ean | string | No | — | European article number. |
attributes | string | No | — | Product attributes. |
price_brutto | number | No | — | Gross price. |
tax_rate | number | No | — | Tax rate. |
quantity | number | No | — | Quantity. |
weight | number | No | — | Weight. |
base_orders_set_order_return_fields
Update fields of an order return. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
return_id | number | Yes | — | Return identifier. |
admin_comments | string | No | — | Internal notes. |
extra_field_1 | string | No | — | Custom extra field 1. |
extra_field_2 | string | No | — | Custom extra field 2. |
custom_extra_fields | object | No | — | Custom extra fields as key-value pairs. |
base_orders_set_order_return_status
Change the status of an order return. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
return_id | number | Yes | — | Return identifier. |
status_id | number | Yes | — | New status identifier. |
base_orders_set_order_status
Change the status of a single order. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_id | number | Yes | — | Order identifier. |
status_id | number | Yes | — | New status identifier. |
base_orders_set_order_statuses
Change the status of multiple orders at once. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
order_ids | string[] | Yes | — | Array of order IDs. |
status_id | number | Yes | — | Status to apply to all orders. |

