Order Change Reject V1 Ep
POST/v1/order/change/reject
Reject Order Change
Marks an order change as rejected and creates a log entry.
Headers
| Header | Type | Required | Description |
|---|---|---|---|
| X-Tenant-Name | str | No | Name of the origin tenant making the request |
Request
At least one identifier is required.
id: str | None = None
Unique identifier of the order change (from /order/change/all response).
origin_order_number: str | None = None
Order number from the origin system.
destination_order_number: str | None = None
Order number in the destination system.
reason_code: str | None = None
Optional reason code for the rejection (max 30 characters).
Response
status: str
Crossroads integration status. Each status represents a step in the integration pipeline.
Integration Stages
pending
The request has been accepted and is being processed asynchronously.
requested
The order has been created and is awaiting manual acceptance by the destination tenant.
origin_mapped
The order has been received by crossroads and needs mapping to crossroads master data.
master_mapped
The order has been mapped to crossroads master data and needs mapping to the destination system.
destination_mapped
The order has been mapped to the destination system and is ready to be sent.
synced
The order has been successfully sent to the destination system.
canceled
The order has been canceled.
error
An error occurred during processing. Check the message and log for details.
rejected
The order was rejected by the destination system. Check the message and log for details.
message: str | None = None
Status message or error details.
log: CrossroadsLogV2 | None = None
Processing log entry.
order_change: OrderChangeView
The rejected order change details.
id: str
Unique identifier of the order change.
origin_order_number: str
Order number from the origin system.
destination_order_number: str | None = None
Order number in the destination system.
status: IntegrationStatus
Current status of the change.
change_types: list[OrderChangeType]
Types of changes in this record.
created_on: datetime
When the change was created.
updated_on: datetime | None = None
When the change was last updated.
origin_tenant_name: str
Name of the origin tenant.
destination_tenant_name: str | None = None
Name of the destination tenant.
submit_reason_code: str | None = None
Reason code provided when the change was submitted.
rejected_reason_code: str | None = None
Reason code provided when the change was rejected.
accept_reason_code: str | None = None
Reason code provided when the change was accepted.
Responses
- 200
- 422
Successful Response
- application/json
- Example (from schema)
{
"status": "origin_mapped",
"order_change": {
"id": "string",
"origin_order_number": "string",
"destination_order_number": "string",
"status": "origin_mapped",
"change_types": [
"supply_change"
],
"created_on": "2026-05-11T19:25:51.356Z",
"updated_on": "2026-05-11T19:25:51.356Z",
"origin_tenant_name": "string",
"destination_tenant_name": "string",
"required_manual_approval": false,
"approved_by": "string",
"approved_on": "2026-05-11T19:25:51.356Z",
"rejected_by": "string",
"rejected_on": "2026-05-11T19:25:51.356Z",
"rejected_reason_code": "string",
"submit_reason_code": "string",
"accept_reason_code": "string"
},
"message": "string",
"log": {
"_id": "5eb7cf5a86d9755df3a6c593",
"title": "string",
"date": "2026-05-11T19:25:51.357Z",
"status": "unknown",
"severity": "low",
"routing": {
"origin_tenant_id": "string",
"origin_tenant_name": "string",
"origin_source_system": "string",
"origin_source_system_id": "string",
"origin_instance_id": "string",
"origin_instance_name": "string",
"destination_tenant_id": "string",
"destination_tenant_name": "string",
"destination_source_system": "string",
"destination_source_system_id": "string",
"destination_instance_id": "string",
"destination_instance_name": "string"
},
"detail": {
"category": "crossroads",
"message": "Unhandled System Error. Please retry or contact support.",
"message_short": "System Error",
"traceback": "string"
},
"metadata": {
"type": "order",
"group_id": "string",
"origin_order_number": "string",
"crossroads_order_id": "string"
},
"worker_name": "Crossroads",
"correlation_id": "string",
"retried": false,
"saga_id": "string",
"saga_type": "string",
"send_notification": true,
"outbound_request": {},
"inbound_request": {}
},
"order_row": {
"internal_order": {
"id": "string",
"internal_order_number": "string",
"partner_order_number": "string",
"po": "string",
"status": "origin_mapped",
"order_status": "No Progress",
"trip_status": "no_progress",
"eta": "2026-05-11T19:25:51.358Z",
"assigned_to": "string",
"hauled_by": "string",
"hauled_for": "string",
"units": "gallons",
"integration": "string",
"delivery_window_start": "2026-05-11T19:25:51.358Z",
"delivery_window_end": "2026-05-11T19:25:51.358Z",
"product_ratios": [
{
"name": "string",
"amount": 0,
"volume": 0
}
],
"drops": [
{
"site": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string",
"tank_id": "string",
"tank_goid": "string",
"tank_goid_name": "string",
"product_source_id": "string"
},
"product": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
},
"volume": 0,
"loads": [
{
"terminals": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"products": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"suppliers": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"price_types": [
"rack"
],
"contracts": [
"string"
]
}
],
"extra_data": {}
}
],
"suppliers": [
"string"
],
"origins": [
"string"
],
"destinations": [
"string"
],
"created_date": "2026-05-11T19:25:51.358Z",
"updated_date": "2026-05-11T19:25:51.358Z",
"updated_by": "string",
"created_by": "string",
"routing": {
"origin_tenant_id": "string",
"origin_tenant_name": "string",
"origin_source_system": "string",
"origin_source_system_id": "string",
"origin_instance_id": "string",
"origin_instance_name": "string",
"destination_tenant_id": "string",
"destination_tenant_name": "string",
"destination_source_system": "string",
"destination_source_system_id": "string",
"destination_instance_id": "string",
"destination_instance_name": "string"
},
"failed_log_id": "string",
"integration_error_title": "string",
"integration_error_message": "string",
"pending_change_id": "string",
"pending_change_types": [
"string"
]
},
"partner_order": {
"id": "string",
"internal_order_number": "string",
"partner_order_number": "string",
"po": "string",
"status": "origin_mapped",
"order_status": "No Progress",
"trip_status": "no_progress",
"eta": "2026-05-11T19:25:51.358Z",
"assigned_to": "string",
"hauled_by": "string",
"hauled_for": "string",
"units": "gallons",
"integration": "string",
"delivery_window_start": "2026-05-11T19:25:51.358Z",
"delivery_window_end": "2026-05-11T19:25:51.358Z",
"product_ratios": [
{
"name": "string",
"amount": 0,
"volume": 0
}
],
"drops": [
{
"site": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string",
"tank_id": "string",
"tank_goid": "string",
"tank_goid_name": "string",
"product_source_id": "string"
},
"product": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
},
"volume": 0,
"loads": [
{
"terminals": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"products": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"suppliers": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"price_types": [
"rack"
],
"contracts": [
"string"
]
}
],
"extra_data": {}
}
],
"suppliers": [
"string"
],
"origins": [
"string"
],
"destinations": [
"string"
],
"created_date": "2026-05-11T19:25:51.359Z",
"updated_date": "2026-05-11T19:25:51.359Z",
"updated_by": "string",
"created_by": "string",
"routing": {
"origin_tenant_id": "string",
"origin_tenant_name": "string",
"origin_source_system": "string",
"origin_source_system_id": "string",
"origin_instance_id": "string",
"origin_instance_name": "string",
"destination_tenant_id": "string",
"destination_tenant_name": "string",
"destination_source_system": "string",
"destination_source_system_id": "string",
"destination_instance_id": "string",
"destination_instance_name": "string"
},
"failed_log_id": "string",
"integration_error_title": "string",
"integration_error_message": "string",
"pending_change_id": "string",
"pending_change_types": [
"string"
]
},
"gravitate_order": {
"id": "string",
"internal_order_number": "string",
"partner_order_number": "string",
"po": "string",
"status": "origin_mapped",
"order_status": "No Progress",
"trip_status": "no_progress",
"eta": "2026-05-11T19:25:51.359Z",
"assigned_to": "string",
"hauled_by": "string",
"hauled_for": "string",
"units": "gallons",
"integration": "string",
"delivery_window_start": "2026-05-11T19:25:51.359Z",
"delivery_window_end": "2026-05-11T19:25:51.359Z",
"product_ratios": [
{
"name": "string",
"amount": 0,
"volume": 0
}
],
"drops": [
{
"site": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string",
"tank_id": "string",
"tank_goid": "string",
"tank_goid_name": "string",
"product_source_id": "string"
},
"product": {
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
},
"volume": 0,
"loads": [
{
"terminals": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"products": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"suppliers": [
{
"mapping_id": "5eb7cf5a86d9755df3a6c593",
"source_name": "string",
"source_id": "string",
"goid": "string",
"goid_name": "string"
}
],
"price_types": [
"rack"
],
"contracts": [
"string"
]
}
],
"extra_data": {}
}
],
"suppliers": [
"string"
],
"origins": [
"string"
],
"destinations": [
"string"
],
"created_date": "2026-05-11T19:25:51.359Z",
"updated_date": "2026-05-11T19:25:51.359Z",
"updated_by": "string",
"created_by": "string",
"routing": {
"origin_tenant_id": "string",
"origin_tenant_name": "string",
"origin_source_system": "string",
"origin_source_system_id": "string",
"origin_instance_id": "string",
"origin_instance_name": "string",
"destination_tenant_id": "string",
"destination_tenant_name": "string",
"destination_source_system": "string",
"destination_source_system_id": "string",
"destination_instance_id": "string",
"destination_instance_name": "string"
},
"failed_log_id": "string",
"integration_error_title": "string",
"integration_error_message": "string",
"pending_change_id": "string",
"pending_change_types": [
"string"
]
}
}
}
Validation Error
- application/json
- Example (from schema)
{
"detail": [
{
"loc": [
"string",
0
],
"msg": "string",
"type": "string"
}
]
}