Associate invoices with sales order

POST

/invoices/mapwithorder

Associate one or more existing invoices with a sales orders.

Request

Authorization

OAuth 2.0

Implicit

Add the parameter

Authorization

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

Example:

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

Authorize URL: https://accounts.zoho.com/oauth/v2/auth

Body Params application/json

Examples

Responses

🟢200OK

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/invoices/mapwithorder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "invoice_ids": [
        "982000000567114",
        "982000000567115",
        "982000000567116"
    ]
}'

Response Example

{
    "code": 0,
    "message": "The invoices selected have been associated with their sales orders.",
    "errors": [
        {
            "code": 4001,
            "message": "Customer mismatch between invoice and sales order",
            "ids": [
                "982000000567114"
            ]
        },
        {
            "code": 4002,
            "message": "Invoice is already linked to another sales order",
            "ids": [
                "982000000567115"
            ]
        },
        {
            "code": 4003,
            "message": "Sales order is in void status and cannot be linked",
            "ids": [
                "982000000567116"
            ]
        }
    ]
}

Modified at 2025-10-12 16:28:37

Create an instant invoice

Submit an invoice for approval