---
title: "Add Commercial Invoice"
method: PUT
path: "/v4/shipments/commercialInvoice/{carrierCode}/{shipmentId}"
tags: ["Shipments"]
---

# Add Commercial Invoice

`PUT /v4/shipments/commercialInvoice/{carrierCode}/{shipmentId}`

Add Commercial Invoices associated with your shipments as in the base64-encoded PDF format.

## Path parameters

- `carrierCode` string, required
- `shipmentId` string, required

## Request body

- CommercialInvoiceRequest — Commercial Invoice Request
  - `InvoiceNumber` string, nullable — A unique identifier assigned to each commercial invoice, typically used for tracking and reference purposes.
  - `InvoiceDate` string, date, nullable — The date when the commercial invoice was issued. <br /> <br />***Note**: The invoice date must be in the YYYY-MM-DD format. If the date is not provided, it defaults to today's date.*
  - `Document` string, required — The base64-encoded string of the document to be uploaded. <br /> <br />***Note**: The max file size allowed for the encoded base64 PDF is 2MB.*

## Response `200`

The Commercial Invoice has been successfully linked to the Shipment Id.

## Other responses

- `400` — Invalid request response.
- `401` — Unauthorized
- `403` — Forbidden
- `404` — The shipment was not found.
- `500` — Internal Server Error

---

[API](https://skmtc.dev/intersoftsapient/apis/sapient-core-api.md) · [All operations](https://skmtc.dev/intersoftsapient/apis/sapient-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intersoftsapient/sapient-core-api/revisions/3315ad0b5875/schema)