Invoice (810)

This invoice example is the response to the order example shown the Purchase Order page.

Invoice Example Transaction

{
  "invoiceDate": "2024-02-20",
  "invoiceNumber": "INV-2024-001234",
  "purchaseOrderNumber": "PO-2024-001234",
  "releaseNumber": "REL-001",
  "buyersCurrency": {
    "currencyCode": "USD",
    "exchangeRate": "1.00"
  },
  "sellersCurrency": {
    "currencyCode": "USD",
    "exchangeRate": "1.00"
  },
  "parties": {
    "buyer": {
      "name": "Acme Corporation",
      "additionalName1": "Procurement Department",
      "identificationCode": "123456789",
      "identificationCodeType": "duns",
      "addressLine1": "123 Main Street",
      "addressLine2": "Suite 500",
      "city": "Chicago",
      "stateOrProvinceCode": "IL",
      "postalCode": "60601",
      "countryCode": "US",
      "zoneType": "commercial",
      "contacts": [
        {
          "type": "primary",
          "name": "John Smith",
          "phoneNumber": "312-555-0100",
          "email": "[email protected]"
        },
        {
          "type": "orderInquiry",
          "name": "Order Desk",
          "phoneNumber": "312-555-0200",
          "email": "[email protected]"
        }
      ]
    },
    "shipTo": {
      "name": "Acme Corporation - Warehouse",
      "identificationCode": "987654321",
      "identificationCodeType": "duns",
      "addressLine1": "456 Warehouse Boulevard",
      "city": "Elk Grove Village",
      "stateOrProvinceCode": "IL",
      "postalCode": "60007",
      "countryCode": "US",
      "zoneType": "commercial",
      "contacts": [
        {
          "type": "receiving",
          "name": "Receiving Department",
          "phoneNumber": "847-555-0300"
        }
      ]
    },
    "billTo": {
      "name": "Acme Corporation",
      "identificationCode": "123456789",
      "identificationCodeType": "duns",
      "addressLine1": "123 Main Street",
      "addressLine2": "Accounts Payable",
      "city": "Chicago",
      "stateOrProvinceCode": "IL",
      "postalCode": "60601",
      "countryCode": "US",
      "contacts": [
        {
          "type": "primary",
          "name": "Accounts Payable",
          "phoneNumber": "312-555-0400",
          "email": "[email protected]"
        }
      ]
    },
    "accountsReceivable": {
      "name": "Global Suppliers Inc. - AR",
      "identificationCode": "555123456",
      "identificationCodeType": "duns",
      "addressLine1": "789 Manufacturing Drive",
      "city": "Dallas",
      "stateOrProvinceCode": "TX",
      "postalCode": "75201",
      "countryCode": "US"
    },
    "accountsPayable": {
      "name": "Acme Corporation - AP",
      "addressLine1": "123 Main Street",
      "addressLine2": "Finance Department",
      "city": "Chicago",
      "stateOrProvinceCode": "IL",
      "postalCode": "60601",
      "countryCode": "US"
    }
  },
  "references": {
    "customerOrderNumber": {
      "value": "CUST-ORD-789",
      "description": "Customer order reference"
    },
    "vendorNumber": {
      "value": "VND-456",
      "description": "Vendor number"
    },
    "departmentNumber": {
      "value": "DEPT-10",
      "description": "Department code"
    },
    "divisionId": {
      "value": "DIV-001",
      "description": "North American Division"
    },
    "billOfLadingNumber": {
      "value": "BOL-2024-001234",
      "description": "Bill of lading number"
    },
    "trackingNumber": {
      "value": "1Z999AA10123456784",
      "description": "UPS tracking number"
    },
    "shipmentId": {
      "value": "SHIP-2024-001234",
      "description": "Shipment identifier"
    }
  },
  "dates": {
    "shipDate": "2024-02-15",
    "deliveryDate": "2024-02-18"
  },
  "termsOfSale": {
    "type": "basicDiscountOffered",
    "basisDate": "invoiceDate",
    "discountPercent": "2.0",
    "discountDaysDue": 10,
    "discountDueDate": "2024-03-01",
    "discountAmount": "225.00",
    "netDaysDue": 30,
    "netDueDate": "2024-03-21",
    "description": "2/10 Net 30 payment terms",
    "paymentMethodType": "check"
  },
  "carrierDetails": {
    "quantityAndWeight": [
      {
        "ladingQuantity": "25",
        "packageForm": "carton",
        "packageMaterial": "corrugated",
        "weightUOM": "pound",
        "grossWeight": "1250.00",
        "netWeight": "1200.00"
      }
    ],
    "routing": [
      {
        "sequenceType": "origin",
        "standardCarrierAlphaCode": "FEDX",
        "transportationMethod": "commonCarrier",
        "location": "Dallas, TX",
        "locationType": "origin",
        "serviceLevel": "ground",
        "transitDirectionType": "sellerToBuyer",
        "transitTimeType": "workingDays",
        "transitTime": "3",
        "description": "FedEx Ground service"
      }
    ],
    "equipment": {
      "equipmentType": "trailer",
      "equipmentId": "TRL-2024-001",
      "sealNumber": "SEAL-12345"
    },
    "freeOnBoard": [
      {
        "methodOfPayment": "prepaidBySeller",
        "locationType": "origin",
        "locationDescription": "Dallas, TX",
        "titlePassageType": "origin",
        "titlePassageDescription": "Dallas, TX",
        "transportationTermsSource": "tradeTerms",
        "transportationTerms": "freeOnBoard",
        "riskOfLoss": "toDestinationBuyer"
      }
    ]
  },
  "notes": {
    "general": {
      "description": "General invoice notes",
      "text": [
        "Thank you for your business",
        "Please remit payment to the address shown above"
      ]
    }
  },
  "invoiceTotal": "11250.00",
  "invoiceSalesTotal": "11025.00",
  "invoiceTermsDiscount": "225.00",
  "taxes": {
    "stateProvincialTax": {
      "amount": "650.00",
      "percent": "6.5",
      "jurisdictionType": "state",
      "jurisdictionCode": "IL"
    },
    "localTax": {
      "amount": "100.00",
      "percent": "1.0",
      "jurisdictionType": "local",
      "jurisdictionCode": "CHI"
    }
  },
  "allowances": [
    {
      "type": "volume",
      "amount": "500.00",
      "percent": "5.0",
      "percentBasis": "basePrice",
      "methodOfHandling": "paidByVendor",
      "description": "Volume discount for orders over $10,000"
    }
  ],
  "charges": [
    {
      "type": "freight",
      "amount": "250.00",
      "methodOfHandling": "prepaid",
      "description": "Prepaid freight charges"
    },
    {
      "type": "handling",
      "amount": "50.00",
      "methodOfHandling": "prepaid",
      "description": "Handling fee"
    }
  ],
  "lineItems": [
    {
      "purchaseOrderLineId": "1",
      "productIds": {
        "buyerItemNumber": "ACME-12345",
        "vendorItemNumber": "GSI-78901",
        "gtin13": "1234567890123",
        "buyerItemIds": [
          {
            "type": "sku",
            "value": "SKU-ACME-12345"
          }
        ]
      },
      "quantityInvoiced": {
        "value": "100",
        "unitOfMeasure": "each"
      },
      "unitPrice": "45.00",
      "unitPriceBasis": "perEach",
      "countryOfOrigin": "US",
      "lotNumber": "LOT-2024-001",
      "productAttributes": {
        "description": "Premium Widget - Blue",
        "colorCode": "BLU",
        "colorDescription": "Blue",
        "sizeCode": "LG",
        "sizeDescription": "Large",
        "materialCode": "STEEL",
        "materialDescription": "Stainless Steel"
      },
      "outerPack": {
        "numberOfUnits": "10",
        "size": "12",
        "sizeUOM": "each",
        "packageForm": "box",
        "packageMaterial": "corrugated",
        "weightUOM": "pound",
        "grossWeight": "50",
        "netWeight": "45",
        "dimensionUOM": "inch",
        "length": "24",
        "width": "18",
        "height": "12",
        "packageId": "PKG-001"
      },
      "innerPack": {
        "numberOfUnits": "1",
        "size": "1",
        "sizeUOM": "each",
        "packageForm": "box",
        "packageMaterial": "corrugated",
        "weightUOM": "pound",
        "grossWeight": "5",
        "netWeight": "4.5"
      },
      "references": {
        "billOfLadingNumber": {
          "value": "BOL-2024-001234",
          "description": "Bill of lading"
        },
        "trackingNumber": {
          "value": "1Z999AA10123456784",
          "description": "UPS tracking"
        },
        "shipmentId": {
          "value": "SHIP-2024-001234",
          "description": "Shipment ID"
        }
      },
      "allowances": [
        {
          "type": "quantityDiscount",
          "amount": "50.00",
          "percent": "1.0",
          "methodOfHandling": "paidByVendor",
          "description": "Quantity discount for 100+ units"
        }
      ],
      "charges": [
        {
          "type": "handling",
          "amount": "25.00",
          "methodOfHandling": "prepaid",
          "description": "Special handling charge"
        }
      ],
      "carrierDetails": {
        "routing": [
          {
            "sequenceType": "origin",
            "transportationMethod": "commonCarrier",
            "serviceLevel": "ground",
            "description": "Standard ground shipping"
          }
        ]
      },
      "sublineItems": [
        {
          "sublineId": "1-1",
          "quantity": {
            "value": "50",
            "unitOfMeasure": "each"
          },
          "productIds": {
            "buyerItemNumber": "ACME-12345-A",
            "vendorItemNumber": "GSI-78901-A"
          },
          "unitCostPrice": "45.00",
          "unitPriceBasis": "perEach",
          "productAttributes": {
            "description": "Premium Widget - Blue - Variant A",
            "colorCode": "BLU",
            "sizeCode": "LG"
          }
        }
      ]
    },
    {
      "purchaseOrderLineId": "2",
      "productIds": {
        "buyerItemNumber": "ACME-67890",
        "vendorItemNumber": "GSI-23456",
        "gtin14": "12345678901234"
      },
      "quantityInvoiced": {
        "value": "250",
        "unitOfMeasure": "case"
      },
      "unitPrice": "18.50",
      "unitPriceBasis": "perEach",
      "productAttributes": {
        "description": "Standard Widget - Red",
        "colorCode": "RED",
        "colorDescription": "Red",
        "sizeCode": "MD",
        "sizeDescription": "Medium"
      },
      "outerPack": {
        "numberOfUnits": "25",
        "size": "1",
        "sizeUOM": "case",
        "packageForm": "box",
        "packageMaterial": "corrugated",
        "weightUOM": "pound",
        "grossWeight": "30",
        "netWeight": "28"
      },
      "references": {
        "trackingNumber": {
          "value": "1Z999AA10123456785",
          "description": "UPS tracking"
        }
      }
    },
    {
      "purchaseOrderLineId": "3",
      "productIds": {
        "buyerItemNumber": "ACME-11111",
        "vendorItemNumber": "GSI-33333",
        "gtin12": "123456789012"
      },
      "quantityInvoiced": {
        "value": "50",
        "unitOfMeasure": "each"
      },
      "unitPrice": "17.50",
      "unitPriceBasis": "perEach",
      "countryOfOrigin": "CN",
      "productAttributes": {
        "description": "Basic Widget - Green",
        "colorCode": "GRN",
        "colorDescription": "Green"
      }
    }
  ]
}