Generate invoice

Generates invoice for the given invoice type such as, shipment, appeasement, and so on.

POST /invoice

Generate invoice

cURL

curl --request POST \
  --url https://prod01.oms.fabric.inc/api/v2/invoice/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-site-context: <x-site-context>' \
  --data '
{
  "detailType": "ORDER_CREATE/ORDER_RETURNS",
  "detail": {
    "channel": "ship1233234555g",
    "tenant": "ship1233234555g",
    "id": "ship1233234555g",
    "documentType": "ORDER",
    "invoiceType": "SHIPMENT",
    "orderNumber": "ship1233234555g"
  }
}
'

201

{
  "invoiceId": "62ff5c0bec0aed3c86202c32",
  "shipmentId": "62ff5c0bec0aed3c86202c32",
  "statusCode": "CREATED/POSTED/ACKNOWLEDGED",
  "channelId": "strate",
  "invoiceTotal": 245.7,
  "totalTaxAmount": 245.7,
  "currency": "dollar",
  "invoiceNumber": "23940791",
  "invoiceStatus": "CAPTURED/SETTLED",
  "invoiceType": "SHIPPING/APPEASEMENT",
  "invoiceDate": "2022-08-01T20:03:28.483971941Z",
  "shipmentNumber": "217088603",
  "shippedOn": "2022-08-01T20:03:28.483971941Z",
  "orders": [
    {
      "orderId": "62ff5c0bec0aed3c86202c32",
      "invoiceOrderTotal": 245.7,
      "orderNumber": "217088603",
      "orderDate": "2022-05-12T09:30:31.198Z",
      "orderType": "WEB",
      "orderSubType": "International",
      "items": [
        {
          "lineItemId": "1adfrghhh2346aaaf",
          "lineItemNumber": 1,
          "shipmentLineItemId": "<string>",
          "itemId": "1234",
          "orderId": "<string>",
          "type": "WEB_PICKUP",
          "sku": "P1234",
          "invoiceQuantity": 10,
          "itemUnitPrice": 123,
          "invoiceLineTotal": 600,
          "itemDiscountsTotal": 123,
          "itemTaxTotal": 123,
          "itemFeeTotal": 123,
          "itemAppeasementTotal": 123,
          "lineItemCreatedAt": "2023-11-07T05:31:56Z",
          "locationStoreId": "<string>",
          "returnExpiryDays": "<string>",
          "currency": "<string>",
          "fees": [
            {
              "type": "tax",
              "value": 34.56
            }
          ],
          "taxDetail": [
            {
              "type": "tax",
              "value": 34.56
            }
          ],
          "appeasements": [
            {
              "appeasementCounter": 1,
              "reasonCode": "Incorrect Item",
              "subReasonCode": "Late shipping",
              "value": 34.56,
              "invoiceValue": 34.56,
              "payments": [
                {
                  "paymentCounter": 1,
                  "refundAmount": 40
                }
              ]
            }
          ],
          "discount": [
            {
              "quantity": 2,
              "value": 2,
              "promoId": "HNY2022",
              "promoCode": "HNY2022",
              "promoTitle": "Happy New Year",
              "type": "promotion"
            }
          ],
          "shipToId": "5349b4ddd2781d08c09890f4",
          "returns": [
            {
              "shipmentLineItemId": "<string>",
              "shipmentQuantity": 123,
              "refundAmount": 123,
              "reasonCode": "<string>",
              "invoiceDate": "2023-11-07T05:31:56Z"
            }
          ],
          "attributes": {},
          "uom": "<string>"
        }
      ],
      "payments": [
        {
          "paymentCounter": 123,
          "paymentDate": "2022-01-27T16:15:58.000-05:00",
          "billToId": "62272e917b12209e68751d94",
          "paymentIdentifier": {
            "cardIdentifier": "***********3456"
          },
          "paymentProvider": "stripe",
          "paymentToken": {
            "token": "pi_34tr6787rt"
          },
          "paymentMethod": "CREDIT_CARD",
          "paymentType": "VISA",
          "currency": "USD",
          "conversion": 1,
          "paymentStatus": "OK",
          "attributes": {},
          "billToAddress": {
            "addressLine1": "<string>",
            "addressLine2": "<string>",
            "addressLine3": "<string>",
            "addressLine4": "<string>",
            "city": "<string>",
            "state": "<string>",
            "country": "<string>",
            "postalCode": "<string>",
            "type": "<string>",
            "contact": [
              {
                "type": "<string>",
                "email": "<string>",
                "phone": [
                  {
                    "number": "<string>",
                    "type": "<string>"
                  }
                ],
                "name": {
                  "first": "<string>",
                  "middle": "<string>",
                  "last": "<string>"
                }
              }
            ]
          },
          "settlement": {
            "settlementDate": "2022-01-27T16:15:58-05:00",
            "settlementStatusCode": "SETTLED",
            "settlementAmount": 123,
            "attributes": {}
          },
          "authAmount": 123
        }
      ],
      "fees": [
        {
          "type": "tax",
          "value": 34.56
        }
      ],
      "appeasements": [
        {
          "appeasementCounter": 1,
          "reasonCode": "Incorrect Item",
          "subReasonCode": "Late shipping",
          "value": 34.56,
          "invoiceValue": 34.56,
          "payments": [
            {
              "paymentCounter": 1,
              "refundAmount": 40
            }
          ]
        }
      ],
      "discounts": [
        {
          "quantity": 2,
          "value": 2,
          "promoId": "HNY2022",
          "promoCode": "HNY2022",
          "promoTitle": "Happy New Year",
          "type": "promotion"
        }
      ],
      "taxDetail": [
        {
          "type": "tax",
          "value": 34.56
        }
      ],
      "attributes": {}
    }
  ],
  "locationNum": 3235,
  "location": "object",
  "retail": {
    "locationNum": 123,
    "cashierId": "<string>"
  },
  "createdAt": "2022-08-01T20:03:28.483971941Z",
  "updatedAt": "2022-08-01T20:03:28.483971941Z",
  "postedAt": "2022-08-01T20:03:28.483971941Z",
  "acknowledgedAt": "2022-08-01T20:03:28.483971941Z",
  "customer": {
    "name": {
      "first": "John",
      "middle": "Middle",
      "last": "Doe"
    },
    "email": "[e-mail]",
    "phone": {
      "number": "55555555555",
      "type": "MOBILE"
    },
    "userId": "62272e917b12209e68751d94",
    "accountId": "62272e917b12209e68751d94",
    "employeeId": "62272e917b12209e68751d94",
    "company": "Fabric",
    "address": {
      "addressLine1": "<string>",
      "addressLine2": "<string>",
      "addressLine3": "<string>",
      "addressLine4": "<string>",
      "city": "<string>",
      "state": "<string>",
      "country": "<string>",
      "postalCode": "<string>",
      "type": "<string>",
      "contact": [
        {
          "type": "<string>",
          "email": "<string>",
          "phone": [
            {
              "number": "<string>",
              "type": "<string>"
            }
          ],
          "name": {
            "first": "<string>",
            "middle": "<string>",
            "last": "<string>"
          }
        }
      ]
    }
  },
  "auditLogs": [
    {
      "lineItemId": "b03b72dc-78d8-4ea4-90fc-2fe6a1fe6569",
      "auditId": "62272e917b12209e68751d94",
      "auditType": "<string>",
      "employeeId": "62272e917b12209e68751d94",
      "auditTimestamp": "2022-05-12T09:24:54.804Z",
      "source": "POS",
      "reasonCode": "POS",
      "subReasonCode": "POS",
      "policyCode": "POS",
      "note": "Note",
      "lineItemNumber": 1,
      "sku": "F5F",
      "quantity": 1,
      "amount": 2.4,
      "paymentToken": {
        "token": "pi_34tr6787rt",
        "paymentType": "VISA"
      },
      "success": true,
      "paymentResponse": {},
      "updatedFields": [
        {
          "fieldName": "UOM",
          "fieldOriginalValue": "PK"
        }
      ],
      "attributes": {}
    }
  ],
  "shipInfo": {
    "shipToId": "5349b4ddd2781d08c09890f4",
    "taxCode": "FR01",
    "locationNum": "123",
    "pickup": [
      {
        "name": {
          "first": "John",
          "middle": "Middle",
          "last": "Doe"
        },
        "email": "[e-mail]",
        "phone": {
          "number": "55555555555",
          "type": "MOBILE"
        },
        "pickupType": "Primary"
      }
    ],
    "shipToAddress": {
      "address1": "Test Street",
      "name": {
        "first": "John",
        "middle": "Middle",
        "last": "Doe"
      },
      "email": "[e-mail]",
      "phone": {
        "number": "55555555555",
        "type": "MOBILE"
      },
      "address2": "123 Parking Lot",
      "address3": "<string>",
      "address4": "<string>",
      "city": "Beaumont",
      "state": "TX",
      "country": "USA",
      "postalCode": "77705",
      "type": "residence",
      "latitude": 35.294952,
      "longitude": 32.294952
    },
    "taxDetail": [
      {
        "type": "tax",
        "value": 34.56
      }
    ],
    "shipMethod": "Express Delivery",
    "shipToType": "SHIP_TO_ADDRESS",
    "estimatedShipDate": "2022-05-12T09:30:31.198Z",
    "estimatedDeliveryDate": "2022-05-12T09:30:31.198Z",
    "shipToPrice": 20,
    "shipToDiscount": 12.6,
    "shipToTaxTotal": 12.6,
    "shipmentInstructions": "User Instructions",
    "attributes": {}
  },
  "attributes": {}
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-site-context · string · required

The x-site-context header is a JSON object that contains information about the source you wish to pull from. The mandatory account is the 24 character identifier found in Copilot. The channel (Sales channel ID), stage (environment name), and date attributes can be used to further narrow the scope of your data source.

Example:

"{\"date\": \"2023-01-01T00:00:00.000Z\", \"channel\": 12, \"account\": \"1234abcd5678efgh9ijklmno\",\"stage\":\"production\"}"

Body

application/json

EventRequest model

detailType · string · required

Event type

Example:

"ORDER_CREATE/ORDER_RETURNS"

detail · object

Invoice event detail model

Show child attributes

Response

201

application/json

Invoice generated

Invoice Model

invoiceId · string · required

Unique Id of the invoice

Example:

"62ff5c0bec0aed3c86202c32"

shipmentId · string · required

Shipment Id in case of invoice type as Shipment

Example:

"62ff5c0bec0aed3c86202c32"

statusCode · string · required

Current status of the invoice

Example:

"CREATED/POSTED/ACKNOWLEDGED"

channelId · string · required

Required field channel Id

Example:

"strate"

invoiceTotal · number · required

Total amount invoiced

Example:

245.7

totalTaxAmount · number · required

Total tax amount invoiced

Example:

245.7

currency · string · required

Currency type in which amount invoiced

Example:

"dollar"

invoiceNumber · string

Unique number of the invoice

Example:

"23940791"

invoiceStatus · enum<string>

InvoiceStatus Model

Available options: CAPTURED, SETTLED, SETTLE_FAILED, PARTIAL_SETTLED, DRAFT, ISSUED, CREDITED, DELETED

Example:

"CAPTURED/SETTLED"

invoiceType · enum<string>

InvoiceType Model

Available options: RETURN, SHIPPING, APPEASEMENT

Example:

"SHIPPING/APPEASEMENT"

invoiceDate · string<date-time>

Date when order invoiced

Example:

"2022-08-01T20:03:28.483971941Z"

shipmentNumber · string

Shipment Number in case of invoice type as Shipment

Example:

"217088603"

shippedOn · string<date-time>

Date when order shipped

Example:

"2022-08-01T20:03:28.483971941Z"

orders · object[]

order details for the invoice

Show child attributes

locationNum · number

locationNum in case of invoice type as Shipment

Example:

3235

location · object

Invoice Location

Show child attributes

Example:

"object"

retail · object

InvoiceRetail Model

Show child attributes

createdAt · string<date-time>

Date when invoice created

Example:

"2022-08-01T20:03:28.483971941Z"

updatedAt · string<date-time>

Date when invoice updated

Example:

"2022-08-01T20:03:28.483971941Z"

postedAt · string<date-time>

Date when invoice posted for financial process

Example:

"2022-08-01T20:03:28.483971941Z"

acknowledgedAt · string<date-time>

Date when invoice acknowledged

Example:

"2022-08-01T20:03:28.483971941Z"

customer · object

InvoiceCustomer Model

Show child attributes

auditLogs · object[]

Audit log list

Show child attributes

shipInfo · object

OrderShipInfo Model

Show child attributes

attributes · object

Show child attributes