Create or update the invoice on a work order

PUT

/v1/invoices/{invoiceId}

Creates or updates the invoice on a work order and recalculates totals from the submitted items. Send the complete item list each time — this replaces all items, not just the ones that changed.

Required scope: invoices:write

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Invoice saved and totals recalculated successfully.

Bodyapplication/json

🟠400

🟠401

🟠403

🟠404

🟠409

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://dev.api.fieldedge.com/open-api/v1/invoices/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "transactionDate": "2026-09-07T00:00:00Z",
    "dueDate": "2026-09-21T00:00:00Z",
    "items": [
        {
            "itemId": "e5f6a7b8-c9d0-1234-efab-345678901234",
            "catalogItemId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
            "name": "Service Call",
            "description": "Diagnostic visit",
            "price": 89.99,
            "quantity": 2,
            "salesTaxCodeId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
            "warehouseId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
        }
    ]
}'

Response Example

200 - Example invoice response

{
    "invoiceId": "a1b2c3d4-5e6f-47a8-9b0c-d1e2f3a4b5c6",
    "invoiceNumber": "INV-10042",
    "invoiceDate": "2024-06-15T00:00:00.0000000Z",
    "dueDate": "2024-07-15T00:00:00.0000000Z",
    "payStatus": "Due",
    "subtotal": 30,
    "tax": 2.48,
    "total": 32.48,
    "balance": 32.48,
    "salesPersonId": "b2c3d4e5-f6a7-48b9-0c1d-e2f3a4b5c6d7",
    "salesPersonName": "Jane Doe",
    "termsName": "Net 30",
    "taxCodeName": "TX State Tax",
    "departmentName": "Plumbing",
    "billingAddress": {
        "customerId": "b2c3d4e5-f6a7-48b9-0c1d-e2f3a4b5c6d7",
        "customerName": "Acme Corp",
        "name": "John Smith",
        "addressLine1": "456 Oak Ave",
        "addressLine2": "",
        "city": "Austin",
        "state": "TX",
        "postalCode": "78702"
    },
    "items": [
        {
            "itemId": "e5f6a7b8-c9d0-41e2-3f4a-b5c6d7e8f9a0",
            "catalogItemId": "f6a7b8c9-d0e1-42f3-4a5b-c6d7e8f9a0b1",
            "name": "Pipe Installation",
            "description": "Install 1/2-inch copper pipe",
            "quantity": 1,
            "unitPrice": 30,
            "amount": 30,
            "costType": "Labor",
            "itemType": "Assembly",
            "equipmentId": null,
            "equipmentName": null,
            "warehouseId": null,
            "assemblyItems": [
                {
                    "itemId": "c3d4e5f6-a7b8-49c0-1d2e-f3a4b5c6d7e8",
                    "catalogItemId": "d4e5f6a7-b8c9-40d1-2e3f-a4b5c6d7e8f9",
                    "name": "Copper Pipe 1/2\"",
                    "description": "Half-inch copper pipe",
                    "quantity": 2,
                    "unitPrice": 15,
                    "amount": 30,
                    "costType": "Material",
                    "equipmentId": null,
                    "equipmentName": null,
                    "warehouseId": "a7b8c9d0-e1f2-43a4-5b6c-d7e8f9a0b1c2"
                }
            ],
            "flatRateComponents": []
        }
    ]
}

Modified at 2026-10-09 05:36:08

Retrieve an invoice by ID

Retrieve a paginated list of quotes