Change application order

PUT /financing/v1/applications/:applicationId/order

When there's some changes within order before delivery (e.g. change in order items that impacts the total price of the order, or other billing information), use /financing/v1/applications/{applicationId}/order resource in order we can adjust everything properly. {applicationId} is the application ID you received in the response of /financing/v1/applications after its creation.

Financing type	Supported
`DEFERRED_PAYMENT`	YES
`PAY_IN_THREE`	YES

Application state	Availability
`REJECTED`	NO
`CANCELLED`	NO
`PROCESSING`	YES
`READY`	YES *

* Order items can't be changed when some of them are marked as sent (via Mark order items as sent) or delivered (via Mark order items as delivered)

Use /financing/v1/applications/{applicationId}/order resource with properly filled request that contains (only) changed data (resource allows partial put).

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	`NOT_SUPPORTED`	Resource is not supported for given financing type

Request

Path Parameters

applicationId stringrequired

applicationId

application/json

Body

reason stringnullable

Reason of change.

order

object

required

number string

Order number (internal for e-shop)

variableSymbols string[]nullable

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.

totalPrice

object

Financial amount

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

totalVat object[]

Total VAT amounts split by their VAT rates

addresses

object[]

Addresses. Only BILLING and DELIVERY types are allowed.

Array [

name stringnullable

Possible values: <= 100 characters

Name on address

country stringrequired

Country. (see ISO 3166 alpha-2)

city stringrequired

Possible values: <= 100 characters

City

streetAddress stringrequired

Possible values: <= 100 characters

Street/city part

streetNumber stringnullable

Possible values: <= 100 characters

Street number

zip stringrequired

Possible values: <= 30 characters

Postal code

addressType addressTyperequired

Possible values: [PERMANENT, CONTACT, DELIVERY, BILLING]

Type of the address. Only some of the types are allowed in each context.

]

deliveryType deliveryType

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

DeliveryCarrierPredefined
DeliveryCarrierCustom

carrierId carrierIdrequired

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]

carrierCustom carrierCustomrequired

Possible values: <= 250

For carriers not found in the enumeration of carrierId, specify the value as text.

channel channel

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)

reservationDate datetimenullable

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).

items object[]

Order items

documents

object[]

Attached documents (invoices etc.)

Array [

type object

Type of the document

file

object

required

oneOf

MOD1
MOD2

string

description stringnullable

File description

extraData

object

variableSymbol stringnullable

Variable symbol of this document (proforma, invoice, ...). This string must contain only numbers, maximum length is 10 characters (digits). Leading zeros are ignored.

]

Responses

Order was changed

application/json

Schema
Example (from schema)

Schema

number stringrequired

Possible values: <= 100 characters

Order number (internal for e-shop)

variableSymbols string[]

totalPrice

object

required

Order total price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

totalVat

object[]

required

Total VAT amounts split by their VAT rates.

Array [

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

]

addresses

object[]

Addresses. Only BILLING and DELIVERY types are allowed.

Array [

name stringnullable

Possible values: <= 100 characters

Name on address

country stringrequired

Country. (see ISO 3166 alpha-2)

city stringrequired

Possible values: <= 100 characters

City

streetAddress stringrequired

Possible values: <= 100 characters

Street/city part

streetNumber stringnullable

Possible values: <= 100 characters

Street number

zip stringrequired

Possible values: <= 30 characters

Postal code

addressType addressTyperequired

Possible values: [PERMANENT, CONTACT, DELIVERY, BILLING]

Type of the address. Only some of the types are allowed in each context.

]

deliveryType deliveryType

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

DeliveryCarrierPredefined
DeliveryCarrierCustom

carrierId carrierIdrequired

carrierCustom carrierCustomrequired

Possible values: <= 250

For carriers not found in the enumeration of carrierId, specify the value as text.

channel channel

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)

reservationDate datetimenullable

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).

state Order Staterequired

Possible values: [PROCESSING, SENT, DELIVERED, RETURNED, CANCELLED]

Order state.

deliveryDate datenullablerequired

Date and time of delivery

deliveryTrackingNumber stringnullablerequired

Possible values: <= 64 characters

Delivery tracking number

sentDate datenullablerequired

Date and time of order shipping

documents

object[]

Attached documents (invoices etc.)

Array [

type Document Serializerrequired

Possible values: [INVOICE, PROFORMA_INVOICE, CREDIT_NOTE, OTHER]

Type of the document

file

object

required

filename stringrequired

Possible values: <= 100 characters

File name.

url urlrequired

File URL (URL is accessible only 1 hour from its generation for security reasons)

description stringnullable

File description

extraData

object

variableSymbol stringnullable

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

Array [

code stringrequired

Possible values: <= 200 characters

Internal code for item (internal to e-shop). Used to better identify the item for future changes

ean stringnullable

Possible values: <= 64 characters

EAN code.

name stringrequired

Possible values: <= 255 characters

Item name

type Item Typenullable

Possible values: [PHYSICAL, DISCOUNT, SHIPPING_FEE, SALES_TAX, DIGITAL, GIFT_CARD, STORE_CREDIT, FEE, INSURANCE]

Item type

variant stringnullable

Possible values: <= 250 characters

Item variant

description stringnullable

producer stringnullable

Possible values: <= 250 characters

Producer name

categories string[]nullable

List of item categories

totalPrice

object

required

Order items total price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

totalVat

object

required

Order items VAT including VAT rate.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

productUrl urlnullable

Possible values: <= 200 characters

URL of the item in e-shop

state Order Staterequired

Possible values: [PROCESSING, SENT, DELIVERED, RETURNED, CANCELLED]

Order state.

sentDate datenullablerequired

Date when item was sent. Only when the whole order was NOT sent at once.

deliveryDate datenullablerequired

Date when item was delivered. Only when the whole order was NOT sent at once.

deliveryTrackingNumber stringnullablerequired

Possible values: <= 64 characters

Tracking number for the item. Only when the whole order was NOT sent at once.

image

object

filename stringrequired

Possible values: <= 100 characters

File name.

url urlrequired

File URL.

unitPrice

object

required

Order unit item price including VAT.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

unitVat

object

required

Financial amount with VAT rate.

amount numberrequired

Amount in minor units (12590 represents 125,90 CZK) ISO 4217

currency stringrequired

Amount currency. ISO 4217 (only CZK and EUR values are allowed)

vatRate numberrequired

VAT rate as positive number (ie. 15 represents 15% rate). 0 is allowed.

quantity numberrequired

Possible values: >= 1

(positive float/decimal up to 3 decimal places) Item quantity.

]

merchantId stringnullablerequired

Merchant identification

applicationInfo

object

required

Financing application base information

id stringrequired

Unique identifier in Skip Pay

state staterequired

Possible values: [PROCESSING, READY, REJECTED, CANCELLED]

Application state.

stateReason Reason Staterequired

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"
  }
}

Order can not be changed.

application/json

Schema
Example (from schema)

Schema

errors

object[]

required

Array with errors

Array [

code stringrequired

Unique internal error code

message stringrequired

Human readable error description (non-localized)

severity Severityrequired

Possible values: [ERROR, WARN, INFO]

attribute string

JSON path of request attribute that caused the error (if applicable)

ticketId string

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"
    }
  ]
}

Change application order

/financing/v1/applications/:applicationId/order

Request​

Path Parameters

Body

Responses​

Request

Responses