home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Sales order line items creation

Use the Create fulfillments operation

Use the Create fulfillments operation to add fulfillments and generate invoices for sales order line items.

Use the Create fulfillments operation to add fulfillments for the sales order line item and generate invoices for the fulfillments. Keep the following points in mind when you run the "Create fulfillments" operation:

  • Determine the following fields and other required custom fields for the fulfillment:

    • fulfillmentDate

    • quantity

  • Use the state and billTargetDate fields to determine the fulfillments that are to be invoiced on the specified date. For a fulfillment to be invoiced, its state must be SentToBilling . When a bill run is created, it will pick up the fulfillments to be invoiced based on the billTargetDate field.

  • Use the processingOptions nested field to indicate whether an invoice should be generated.

The following API request creates two fulfillments for the sales order line item and also runs billing at the same time.

Request

POST /v1/fulfillments

Request Body

 
{
  "fulfillments": [
    {
      "fulfillmentDate": "2022-01-01",
      "quantity": 5,
      "description": "fulfillment batch 1",
      "state": "SentToBilling",
      "billTargetDate": "2022-01-01",
      "orderLineItemId": "4028828c82819b74018286e02e041bd6",
      "fulfillmentType": "Delivery",
      "trackingNumber": "T-0009872",
      "carrier": "CarrierA",
      "fulfillmentSystem": "SystemA",
      "fulfillmentLocation": "LocationA",
      "externalId": "SRC-0987123"
    },
    {
      "fulfillmentDate": "2022-01-02",
      "quantity": 5,
      "description": "fulfillment batch 2",
      "state": "SentToBilling",
      "billTargetDate": "2022-01-01",
      "orderLineItemId": "4028828c82819b74018286e02e041bd6",
      "fulfillmentType": "Delivery",
      "trackingNumber": "T-00098721",
      "carrier": "CarrierB",
      "fulfillmentSystem": "SystemB",
      "fulfillmentLocation": "LocationB",
      "externalId": "SRC-09871234"
    }
  ],
  "processingOptions": {
    "billingOptions": {
      "documentDate": "2022-01-02",
      "targetDate": "2022-01-02"
    },
    "runBilling": true
  }
}

Last updated: December 11, 2025