Mark order items as sent
PUT/financing/v1/applications/:applicationId/order/send
When some or all order items were shipped to the customer, use /financing/v1/applications/{applicationId}/order/send
resource where {applicationId}
is the application ID you received in the response of /financing/v1/applications
after its creation.
📘 For additional examples and more information, please refer to the Technical guide: Manage your orders.
Financing type | Supported |
---|---|
DEFERRED_PAYMENT | YES |
PAY_IN_THREE | YES |
Application state | Availability |
---|---|
PROCESSING | NO |
REJECTED | NO |
CANCELLED | NO |
READY | YES |
Use /financing/v1/applications/{applicationId}/order/send
resource with an empty request to mark all order items (the whole order) as sent at once.
If you want to mark specific order item/s as sent, use /financing/v1/applications/{applicationId}/order/send
resource with properly filled request that contains sent order items info. In this case request should contain array of sent order items with one or more particular order item identificators (code
/EAN
/name
/type
) - code
, ean
, name
and type
is used for identifying order item sent in Create application
.
💡 TIP: Use an empty request if marking last (those not yet not marked) item(s) on order as sent.
⚠️ If multiple properties (
code
,ean
,name
ortype
) are used for identifying some order item, it all must exact match the item data.
If the request was successfully processed, you receive HTTP status code 200 and object of information about changed order plus basic information about respective application (ID, state, substate).
In other cases, you may receive errors similar to the following ones:
Status code | Code | Explanation |
---|---|---|
400 | INVALID_REQUEST | Request was not well formatted (malformed request syntax, size too large, etc.) |
404 | OBJECT_NOT_FOUND | The requested resource could not be found |
422 | TOTAL_PRICE_LIMIT_EXCEEDED | The total price of all subcontracts exceeded the order total price |
422 | NOT_SUPPORTED | Resource is not supported for given financing type |
System notification. Some or all order items were shipped to customer. Based on application financing type and partner setting, application payment may be processed.
Request
Path Parameters
applicationId
- application/json
Body
Array [
]
Array [
]
- MOD1
- MOD2
- DeliveryCarrierPredefined
- DeliveryCarrierCustom
items
object[]
List of changed items. All items are considered when empty.
Possible values: <= 200 characters
Internal code for item (internal to e-shop). Used to better identify the item for future changes
Possible values: <= 64 characters
EAN code.
Possible values: <= 255 characters
Item name
Possible values: [PHYSICAL
, DISCOUNT
, SHIPPING_FEE
, SALES_TAX
, DIGITAL
, GIFT_CARD
, STORE_CREDIT
, FEE
, INSURANCE
]
Item type
Possible values: >= 1
(positive float/decimal up to 3 decimal places) Item quantity. If empty, considered as whole item quantity is selected
totalPrice
object
The total financial amount of items (from the orderItems
array). You can specify the amount if it differs from the sum of the item prices. If this amount is not specified, application.order.totalPrice
is used.
Amount in minor units (12590 represents 125,90 CZK) ISO 4217
Amount currency. ISO 4217 (only CZK and EUR values are allowed)
totalVat
object[]
Total VAT amounts of items (from orderItems
array) split by their VAT rates.
Amount in minor units (12590 represents 125,90 CZK) ISO 4217
Amount currency. ISO 4217 (only CZK and EUR values are allowed)
VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.
document
object
Attached document (e.g. invoice, credit note etc.)
Possible values: [INVOICE
, PROFORMA_INVOICE
, CREDIT_NOTE
, OTHER
]
Type of the document
file
object
required
oneOf
string
string
File description
extraData
object
Variable symbol of this document (proforma, invoice, ...). This string must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.
Possible values: <= 10 characters
Required if was not specified earlier in ''Create application'' or ''Change application order'' operations. Symbol used for making the payment to your account. This string must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.
Possible values: <= 10 characters
Symbol used for making the payment to your account. This string must contain only numbers, maximum length is 10 characters (digits).
Shipping date
deliveryCarrier
object
oneOf
Possible values: [AIRWAY
, CZ_POST_HAND
, CZ_POST_OFFICE
, CZ_POST_OTHER
, DACHSER
, DB_SCHENKER
, DEUTSCHE_POST_DHL
, DHL
, DHL_EXPRESS
, DHL_FREIGHT
, DPD
, DSV
, FEDEX
, FOFR
, GEBRUDER_WEISS
, GEIS
, GLS
, HDS_COMFORT
, HDS_STANDARD
, IN_TIME
, JAPO_TRANSPORT
, LIFTAGO
, LOCAL_COURIER
, MAGYAR_POSTA
, MALL_DELIVERY
, MALL_DEPOSIT
, MESSENGER
, POSTA_BEZ_HRANIC
, PPL
, PPL_PARCEL_CONNECT
, RABEN
, SAMEDAY
, SDS
, SLOVAK_PARCEL_SERVICE
, SLOVENSKA_POSTA
, SPRING_GDS
, TNT
, TOP_TRANS
, UPS
, WEDO
, WEDO_ULOZENKA
, ZASILKOVNA
]
Possible values: <= 250
For carriers not found in the enumeration of carrierId, specify the value as text.
Possible values: <= 64 characters
Delivery tracking number
Responses
- 200
- 422
Order items or whole order is marked as shipped
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
Array [
]
- DeliveryCarrierPredefined
- DeliveryCarrierCustom
Array [
]
Array [
]
Possible values: <= 100 characters
Order number (internal for e-shop)
Variable symbols for pairing. First symbol in array is used for making the payment to your account (if not specified later in Mark order items as sent
or Mark order items as delivered
) or we expect you make payment on our account with this symbol (if not specified later in Mark order items as returned
operation). Strings must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.
totalVat
object[]
required
Total VAT amounts split by their VAT rates.
Amount in minor units (12590 represents 125,90 CZK) ISO 4217
Amount currency. ISO 4217 (only CZK and EUR values are allowed)
VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.
addresses
object[]
Addresses. Only BILLING
and DELIVERY
types are allowed.
Possible values: <= 100 characters
Name on address
Country. (see ISO 3166 alpha-2)
Possible values: <= 100 characters
City
Possible values: <= 100 characters
Street/city part
Possible values: <= 100 characters
Street number
Possible values: <= 30 characters
Postal code
Possible values: [PERMANENT
, CONTACT
, DELIVERY
, BILLING
]
Type of the address. Only some of the types are allowed in each context.
Possible values: [DELIVERY_CARRIER
, PERSONAL_BRANCH
, PERSONAL_PARTNER
, ONLINE
]
Delivery type, for DELIVERY_CARRIER
type can be further specified by deliveryCarrier
attribute.
deliveryCarrier
object
oneOf
Possible values: [AIRWAY
, CZ_POST_HAND
, CZ_POST_OFFICE
, CZ_POST_OTHER
, DACHSER
, DB_SCHENKER
, DEUTSCHE_POST_DHL
, DHL
, DHL_EXPRESS
, DHL_FREIGHT
, DPD
, DSV
, FEDEX
, FOFR
, GEBRUDER_WEISS
, GEIS
, GLS
, HDS_COMFORT
, HDS_STANDARD
, IN_TIME
, JAPO_TRANSPORT
, LIFTAGO
, LOCAL_COURIER
, MAGYAR_POSTA
, MALL_DELIVERY
, MALL_DEPOSIT
, MESSENGER
, POSTA_BEZ_HRANIC
, PPL
, PPL_PARCEL_CONNECT
, RABEN
, SAMEDAY
, SDS
, SLOVAK_PARCEL_SERVICE
, SLOVENSKA_POSTA
, SPRING_GDS
, TNT
, TOP_TRANS
, UPS
, WEDO
, WEDO_ULOZENKA
, ZASILKOVNA
]
Possible values: <= 250
For carriers not found in the enumeration of carrierId, specify the value as text.
Possible values: [ESHOP
, BRANCH
, FRANCHISE
, TELEPHONE
, INTERNAL
]
Default value: ESHOP
Sales channel, indicates how or where the order is created. (ie. via e-mail, eshop or at a branch)
Date and time until order is reserved.
Until 'reservationDate' Skip Pay will try to notify partner with Application notification about approval or rejection.
After this date and time, e-shop does not guarantee items availability (if application processing is longer, it may endanger order fullfillment).
Possible values: [PROCESSING
, SENT
, DELIVERED
, RETURNED
, CANCELLED
]
Order state.
Date and time of delivery
Possible values: <= 64 characters
Delivery tracking number
Date and time of order shipping
documents
object[]
Attached documents (invoices etc.)
Possible values: [INVOICE
, PROFORMA_INVOICE
, CREDIT_NOTE
, OTHER
]
Type of the document
file
object
required
Possible values: <= 100 characters
File name.
File URL (URL is accessible only 1 hour from its generation for security reasons)
File description
extraData
object
Variable symbol of this document (proforma, invoice, ...). This string must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.
items
object[]
required
Order items
Possible values: <= 200 characters
Internal code for item (internal to e-shop). Used to better identify the item for future changes
Possible values: <= 64 characters
EAN code.
Possible values: <= 255 characters
Item name
Possible values: [PHYSICAL
, DISCOUNT
, SHIPPING_FEE
, SALES_TAX
, DIGITAL
, GIFT_CARD
, STORE_CREDIT
, FEE
, INSURANCE
]
Item type
Possible values: <= 250 characters
Item variant
Possible values: <= 250 characters
Producer name
List of item categories
totalVat
object
required
Possible values: <= 200 characters
URL of the item in e-shop
Possible values: [PROCESSING
, SENT
, DELIVERED
, RETURNED
, CANCELLED
]
Order state.
Date when item was sent. Only when the whole order was NOT sent at once.
Date when item was delivered. Only when the whole order was NOT sent at once.
Possible values: <= 64 characters
Tracking number for the item. Only when the whole order was NOT sent at once.
image
object
Possible values: <= 100 characters
File name.
File URL.
unitVat
object
required
Possible values: >= 1
(positive float/decimal up to 3 decimal places) Item quantity.
Merchant identification
applicationInfo
object
required
Financing application base information
Unique identifier in Skip Pay
Possible values: [PROCESSING
, READY
, REJECTED
, CANCELLED
]
Application state.
Possible values: [PROCESSING_REDIRECT_NEEDED
, PROCESSING_PREAPPROVED
, PROCESSING_VALIDATION_IN_PROGRESS
, REJECTED
, CANCELLED_NOT_PAID
, READY_TO_SHIP
, READY_SHIPPED
, READY_DELIVERED
, READY_PAID
, CANCELLED_RETURNED
]
Describes internal state of application, e.g. when state is PROCESSING - reason why application remains in processing state
{
"number": "AA234",
"variableSymbols": [
"string"
],
"totalPrice": {
"amount": 12590,
"currency": "CZK"
},
"totalVat": [
{
"amount": 12590,
"currency": "CZK",
"vatRate": 15
}
],
"addresses": [
{
"name": "John Doe",
"country": "CZ",
"city": "Prague",
"streetAddress": "Letenská",
"streetNumber": "22",
"zip": "140 00",
"addressType": "PERMANENT"
}
],
"deliveryType": "DELIVERY_CARRIER",
"deliveryCarrier": {
"carrierId": "DPD"
},
"channel": "BRANCH",
"reservationDate": "2017-07-15T00:00:00+02:00",
"state": "PROCESSING",
"deliveryDate": "2017-01-17",
"deliveryTrackingNumber": "EX12221",
"sentDate": "2017-01-12",
"documents": [
{
"type": "INVOICE",
"file": {
"filename": "invoice.pdf",
"url": "https://www.partner.com/file?id=12345"
},
"description": "This is an invoice",
"extraData": {
"variableSymbol": "1234567890"
}
}
],
"items": [
{
"code": "EXC4677-1a",
"ean": "888462064002",
"name": "iPhone 6s 32GB SpaceGray",
"type": "PHYSICAL",
"variant": "32GB SpaceGray",
"description": "Mobile phone with 32GB of RAM",
"producer": "Apple",
"categories": [
"string"
],
"totalPrice": {
"amount": 12590,
"currency": "CZK"
},
"totalVat": {
"amount": 12590,
"currency": "CZK",
"vatRate": 15
},
"productUrl": "https://www.example.com",
"state": "PROCESSING",
"sentDate": "2017-01-10",
"deliveryDate": "2017-01-12",
"deliveryTrackingNumber": "EX21121",
"image": {
"filename": "invoice.pdf",
"url": "https://www.partner.com/file?id=12345"
},
"unitPrice": {
"amount": 12590,
"currency": "CZK"
},
"unitVat": {
"amount": 12590,
"currency": "CZK",
"vatRate": 15
},
"quantity": 1
}
],
"merchantId": "ABCD1234",
"applicationInfo": {
"id": "11200a0ee1",
"state": "PROCESSING",
"stateReason": "PROCESSING_REDIRECT_NEEDED"
}
}
State change can not be processed
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
errors
object[]
required
Array with errors
Unique internal error code
Human readable error description (non-localized)
Possible values: [ERROR
, WARN
, INFO
]
JSON path of request attribute that caused the error (if applicable)
Internal ticket ID, used for error backtracking
{
"errors": [
{
"code": "ERR_1000_SOME_ERROR_CODE",
"message": "Some error/validation message description",
"severity": "ERROR",
"attribute": "personalBirthNumber",
"ticketId": "UAT1:AMS:20160516-091658.450:45e4"
}
]
}