Light Mode

Create Invoice

POST/orders/invoices

Last modified: 7 days ago

This endpoint allows you to create an invoice to a specific order from your side.

:::tip[Note]
For the order data type, you will need to specify the Invoice issuance to be from Salla.
However, for the other data types available, such as data, url, and file, you will need to set it to custom from the Store Settings.
:::

`orders.read_write` - Orders Read & Write

Request

Authorization: OAuth 2.0

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

order_id

integer

required

Order ID. List of Order IDs can be found here

Example:

1818813486

type

enum<string>

required

Invoice Type. Note that you cannot create a credit_note invoice type before creating a tax_invoice type

Allowed values:

tax_invoicecredit_note

Example:

tax_invoice

data_type

enum<string>

required

Invoice Data Type.

Allowed values:

dataurlfileorder

Example:

data

url

string

optional

URL Link to the PDF file. The variable is requiredif data_type is url.

Example:

https://i.ibb.co/jyqRQfQ/invoice.pdf

invoice_number

string | integer

optional

Invoice Number. The variable is requiredif data_type is data.

Example:

2sdfs435d

sub_total

number

optional

Invoice Subtotal Cost. The variable is requiredif data_type is data.

Example:

999

total

number

optional

Invoice Total Cost. The variable is requiredif data_type is data.

Example:

7789

shipping_cost

number

optional

Invoice Shipping Cost. The variable is requiredif data_type is data.

Example:

cash_on_delivery_cost

number

optional

Invoice COD Cost. The variable is requiredif data_type is data.

Example:

789

tax

number

optional

Tax Cost Percentage. The variable is requiredif data_type is data.

Example:

tax_value

integer

optional

Tax Value Cost. The variable is requiredif data_type is data.

Example:

35.3

{
  "order_id": 1818813486,
  "type": "tax_invoice",
  "data_type": "data",
  "url": "https://i.ibb.co/jyqRQfQ/invoice.pdf",
  "invoice_number": "2sdfs435d",
  "sub_total": 999,
  "total": 7789,
  "shipping_cost": 78,
  "cash_on_delivery_cost": 789,
  "tax": 10,
  "tax_value": 35.3
}

Request samples

Responses

Success(200)

Not Found(404)

Error Validation(422)

Unauthorized(401)

HTTP Code: 200

Content Type : JSONapplication/json

status

number

optional

Response status code, a numeric or alphanumeric identifier used to convey the outcome or status of a request, operation, or transaction in various systems and applications, typically indicating whether the action was successful, encountered an error, or resulted in a specific condition.

success

boolean

optional

Response flag, boolean indicator used to signal a particular condition or state in the response of a system or application, often representing the presence or absence of certain conditions or outcomes.

data

#/definitions/2032046

optional

{
  "status": 200,
  "success": true,
  "data": {
    "id": 1333835642,
    "order_id": 1371877152,
    "type": "Tax Invoice",
    "invoice_number": "2sdfs435d",
    "sub_total": {
      "amount": 999,
      "currency": "ر.س"
    },
    "shipping_cost": {
      "amount": 78,
      "currency": "ر.س"
    },
    "cod_cost": {
      "amount": 789,
      "currency": "ر.س"
    },
    "discount": {
      "amount": 0,
      "currency": "ر.س"
    },
    "tax": {
      "percent": 10,
      "amount": {
        "amount": 35.3,
        "currency": "ر.س"
      }
    },
    "total": {
      "amount": 7789,
      "currency": "ر.س"
    },
    "date": "2022-03-23",
    "items": [
      {
        "name": "فستان فراولة",
        "quantity": 1,
        "price": {
          "amount": "90.50",
          "currency": "SAR"
        },
        "discount": {
          "amount": "0.00",
          "currency": "SAR"
        },
        "tax": {
          "percent": "15.00",
          "amount": {
            "amount": "13.58",
            "currency": "SAR"
          }
        },
        "total": {
          "amount": 104.08,
          "currency": "SAR"
        }
      }
    ]
  }
}

Last modified: 7 days ago