Order-States

This endpoint allows you to update the state of an order based on your internal workflow.

Endpoint
Headers
Methods
- POST

Endpoint

https://api.sevensenders.com/v2/docs.html#/OrderState/postOrderStateCollection

Headers

Parameter	Mandatory	Description
API-KEY	YES	Your authorization key to access Seven Senders API

Methods

POST

Parameters

Parameter	Mandatory	Type	Example	Description
shop_order_id	YES	string	"123456789"	The order reference inside your system
state	YES	choice: See the list of choices below	"paid"	The current state of the order
datetime	YES	date: dd.mm.yyyy hh:mm:ss	"2017-08-15T16:53:07+01:00"	Date when the order changed to this status inside your system
location	NO	string	"Schwedter strasse 36A 10435 Berlin"	The physical location of the order

States available

State

new

paid

in_production

in_preparation

refunded

PLEASE NOTE:
Refunded can only be updated with this end point IF the order has NO order items.

IF the order HAS order items, this status is triggered by the status of the order items.

Request

Curl example

curl -X "POST" -d "shop_order_id=123&state=paid&datetime=2017-08-03T01:00:00+0000&location=\"Schwedter+str.+36A+10435+Berlin\"" -H "Accept:\ application/json" -H "Content-type:\ application/x-www-form-urlencoded" -H "API-KEY:\ <API-KEY>" http:///api.sevensenders.com/v2/order-states.json

Response

Response headers

201 success
status: 201
date: Tue, 05 Sep 2017 11:59:02 GMT
cache-control: no-cache, private
server: nginx
location: /v2/orders/4434712
content-type: application/json

Did you find it helpful? Yes No