Create An Invoice

API Reference for Creating an Invoice

If a shipment was booked through the MyCarrier system, and you can access MyInvoiceHub through your subscription, your invoices will automatically be sent to MyCarrier. However, we know that not all of our customers' shipments may have originated within our platform. For this reason, we wanted to give customers the ability to manually create invoices so they can have a centralized place to manage their freight spend, view analytics, and create reports on all of their shipments, regardless of where they originated.

ThePOST/api/v2/Integrations/Invoices/Createendpoint can be used to create an invoice in MyCarrier that includes all necessary information, such as:

Origin/Destination Details
Line Items
Commodities
Accessorials
Payment Terms
Shipment Details

As well as all other necessary data points.

Required Fields

invoiceNumber (string): Internal idetifier for invoices
carrierCode (string): 4 letter SCAC code that specifies the carrier who dispatched and will be receiving payment for this shipment.
invoiceDateTime (date-time): Time the invoice was created in ISO 8601 format
carrierProNumber (string): The Pro# for the shipment that this invoice applies to.

Sample Request

This example object contains only the required fields and meets the minimum requirements needed to successfully create an invoice through the API.

[
  {
    "invoiceNumber": "1234582025",
    "carrierCode": "ODFL",
    "invoiceDateTime": "2025-01-01T14:15:22Z",
    "termsOfSaleDueDate": null,
    "createdBy": "string",
    "shipment": {
      "carrierProNumber": "10123456789",
      "customerBOLNumber": "string",
      "poNumber": "string",
      "delivery": {
        "estimatedDate": null,
        "actualDate": null
      },
      "pickup": {
        "estimatedDate": null,
        "actualDate": null
      },
      "shipperInfo": {
        "companyName": "string",
        "streetLine1": "string",
        "streetLine2": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country": "string",
        "contactName": "string",
        "contactEmail": "string",
        "contactPhone": "string"
      },
      "consigneeInfo": {
        "companyName": "string",
        "streetLine1": "string",
        "streetLine2": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country": "string",
        "contactName": "string",
        "contactEmail": "string",
        "contactPhone": "string"
      },
      "requesterInfo": {
        "companyName": "string",
        "streetLine1": "string",
        "streetLine2": "string",
        "city": "string",
        "state": "string",
        "zip": "string",
        "country": "string"
      },
      "commodities": [
        {
          "description": "string",
          "piecesNumber": 0,
          "totalWeight": 0,
          "freightClassCode": "string",
          "packingType": "string"
        }
      ],
      "lineItems": [
        {
          "description": "string",
          "amount": 0,
          "chargeCode": "string"
        }
      ]
    }
  }
]