Create Invoice - Salla Merchants APIs

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

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.

Scopes

orders.read_write - Orders Read & Write

Request

Authorization

Add the parameter

Authorization

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

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Examples

Example | `Data` Data Type ResponseExample | `URL` Data Type ResponseExample | `File` Data Type Response

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

🟠404Not Found

🟠422Error Validation

🟠401Unauthorized