Skip to main content
POST
Create a fleet charging key order

Authorizations

X-API-Key
string
header
required

API key for authentication

Body

application/json

Request body for creating a fleet charging key order.

fleetId
string
required

Customer-provided fleet identifier. Must match the value used when the fleet was created via POST /emp/v1/fleets.

Example:

"fleet-123"

productId
string
required

Encoded public product ID as returned by GET /emp/v1/products.

Example:

"Nk375yz7Gw"

address
ChargingKeyOrderAddressRequest · object
required

Delivery address for the order.

printing
object

Optional printing payload. Requirements are product-specific — use the printing.schema from product discovery to build and validate this object before submitting. Drive API forwards this payload unchanged to the fulfilment system.

Example:

Response

OK

EMP charging key order product details.

id
string
required

Unique identifier of the order product.

Example:

"aYnky297eG"

address
object
required

Delivery address for this order product.

quantity
number
required

Number of product units ordered.

Example:

1

language
string
required

Language used for order communication.

Example:

"en"

product
object
required

Ordered product code or type.

created
string<date-time>
required

UTC timestamp when this product order was created.

Example:

"2023-06-26T10:00:00Z"

organizationId
string
required

Identifier of the organization that placed the order.

Example:

"JoEl1xoP7r"

status
enum<string>
required

Current processing status of the order product.

Available options:
WAITING_FOR_ORDER,
ORDER_PLACED,
ORDER_PROCESSING,
ORDER_ASSIGNED,
ORDER_PAID,
ORDER_CANCELLED,
ORDER_CANCELLING,
ORDER_PAYMENT_FAILED,
ORDER_REFUND_FAILED,
ORDER_WAITING_REFUND,
ORDER_REFUNDED,
PAYMENT_ONGOING,
ORDER_FILLED,
ORDER_PAYED,
PREPARE_RECEIPT,
ORDER_PAYED_WITHOUT_RECEIPT
Example:

"ORDER_PAID"

updated
string<date-time>
required

UTC timestamp when this product order was last updated.

Example:

"2023-06-26T12:00:00Z"

printing
object

Printing details associated with the order product. Present only for orders that include physical card customization.