---
title: "saveElectronicInvoice"
method: POST
path: "/electronicinvoice/v1/saveElectronicInvoice"
tags: ["Electronic Invoice Service (beta)"]
---

# saveElectronicInvoice

`POST /electronicinvoice/v1/saveElectronicInvoice`

<b>(beta version) - Customer Restricted Access</b> 
 Uploads e-invoice data for vendor orders.

## Headers

- `authenticationtoken` string, required
- `password` string, required
- `sitename` string, required
- `userid` string, required
- `X-B3-TraceId` string

## Request body

- ElectronicInvoiceDetailsList — ElectronicInvoiceDetailsList description
  - `electronicInvoiceDetails` ElectronicInvoiceDetails[]
    - `electronicInvoiceDetailRowList` ElectronicInvoiceDetailsDto[]
      - `catchWeightInd` string — Indicates whether the “Invoice Quantity” and “Invoice Price” are in Vendor Units (‘N’) or Inventory Units (‘Y’). If left blank, will be interpreted as ‘N’.
      - `creditValue` string — Value of any credit that should be applied to the Extended Value of the line item to adjust the Invoice Price.
      - `extendedValue` string — The Total Invoice Value of the line item. Should be equal to [(Invoice Quantity x Invoice Price) + Tax Value].
      - `invoicePrice` string — The vendor's Invoice Price for the product line item.
      - `invoiceQuantity` string — The vendor's Invoice Quantity for the product line item.
      - `lotNumber` string — The Lot Number associated with the product.
      - `manufacturerNumber` string — The Manufacturer's Number for the product.
      - `productBrand` string — The manufacturer's Brand for the product.
      - `splitIndicator` string — Indicates a Split Unit or Substitute Vendor Product ('Y' or 'N') as defined on the Vendor Bids screen.
      - `subsIndicator` string — Indicates whether the Vendor Product on the original order has been substituted ('Y' or 'N') with a different vendor product.
      - `subsPackageConversion` string — The Vendor's Conversion for the substitute product. This is the number of Inventory Units in 1 Substitute Vendor Product Unit.
      - `subsProductName` string — The Vendor's Product Name for the substitute product.
      - `subsProductNumber` string — The Vendor's Product Number for the substitute product.
      - `subsProductPackageType` string — The Vendor's Package Type/Unit for the substitute product.
      - `taxValue` string — The line item Tax Value for the product.
      - `traceabilityCode` string — The Traceability Code for the product.
      - `traceabilityCodeSource` string — The Traceability Code Source for the product.
      - `vendorPortalId` string — The Vendor Portal ID.
      - `vendorProductNumber` string, required — The Vendor's Product Number for the product line item.
    - `electronicInvoiceHeaderDetails` ElectronicInvoiceHeaderDto — ElectronicInvoiceHeaderDto description
      - `expectedDeliveryDate` string, required — The Expected Delivery Date for the order.
      - `invoiceDate` string, required — The vendor's Invoice Date for the order.
      - `invoiceValue` string — The Total Invoice Value for the order.
      - `locationCode` string, required — The Code for the Location associated with the order.
      - `misc1Amount` string — The amount of the Misc. 1 charge for the order.
      - `misc1GlDescription` string — The GL account associated with the Misc. 1 charge for the order.
      - `misc2Amount` string — The amount of the Misc. 2 charge for the order.
      - `misc2GlDescription` string — The GL account associated with the Misc. 2 charge for the order.
      - `shippingAmount` string — The amount of the Freight/Shipping charge for the order.
      - `shippingGlDescription` string — The GL account associated with the Freight/Shipping charge for the order.
      - `taxAmount` string — The amount of the Tax charged for the order.
      - `taxGlDescription` string — The GL account associated with the Tax charged for the order.
      - `transactionNumber` string — The Transaction Number for the order. Only required if updating an existing vendor order.
      - `vendorCode` string, required — The Code for the vendor associated with the order.
      - `vendorInvoiceNumber` string — The vendor's Invoice Number for the order.
  - `locationCode` string

## Response `200`

Success

- ElectronicInvoiceDetailsList — ElectronicInvoiceDetailsList description
  - `electronicInvoiceDetails` ElectronicInvoiceDetails[]
    - `electronicInvoiceDetailRowList` ElectronicInvoiceDetailsDto[]
      - `catchWeightInd` string — Indicates whether the “Invoice Quantity” and “Invoice Price” are in Vendor Units (‘N’) or Inventory Units (‘Y’). If left blank, will be interpreted as ‘N’.
      - `creditValue` string — Value of any credit that should be applied to the Extended Value of the line item to adjust the Invoice Price.
      - `extendedValue` string — The Total Invoice Value of the line item. Should be equal to [(Invoice Quantity x Invoice Price) + Tax Value].
      - `invoicePrice` string — The vendor's Invoice Price for the product line item.
      - `invoiceQuantity` string — The vendor's Invoice Quantity for the product line item.
      - `lotNumber` string — The Lot Number associated with the product.
      - `manufacturerNumber` string — The Manufacturer's Number for the product.
      - `productBrand` string — The manufacturer's Brand for the product.
      - `splitIndicator` string — Indicates a Split Unit or Substitute Vendor Product ('Y' or 'N') as defined on the Vendor Bids screen.
      - `subsIndicator` string — Indicates whether the Vendor Product on the original order has been substituted ('Y' or 'N') with a different vendor product.
      - `subsPackageConversion` string — The Vendor's Conversion for the substitute product. This is the number of Inventory Units in 1 Substitute Vendor Product Unit.
      - `subsProductName` string — The Vendor's Product Name for the substitute product.
      - `subsProductNumber` string — The Vendor's Product Number for the substitute product.
      - `subsProductPackageType` string — The Vendor's Package Type/Unit for the substitute product.
      - `taxValue` string — The line item Tax Value for the product.
      - `traceabilityCode` string — The Traceability Code for the product.
      - `traceabilityCodeSource` string — The Traceability Code Source for the product.
      - `vendorPortalId` string — The Vendor Portal ID.
      - `vendorProductNumber` string, required — The Vendor's Product Number for the product line item.
    - `electronicInvoiceHeaderDetails` ElectronicInvoiceHeaderDto — ElectronicInvoiceHeaderDto description
      - `expectedDeliveryDate` string, required — The Expected Delivery Date for the order.
      - `invoiceDate` string, required — The vendor's Invoice Date for the order.
      - `invoiceValue` string — The Total Invoice Value for the order.
      - `locationCode` string, required — The Code for the Location associated with the order.
      - `misc1Amount` string — The amount of the Misc. 1 charge for the order.
      - `misc1GlDescription` string — The GL account associated with the Misc. 1 charge for the order.
      - `misc2Amount` string — The amount of the Misc. 2 charge for the order.
      - `misc2GlDescription` string — The GL account associated with the Misc. 2 charge for the order.
      - `shippingAmount` string — The amount of the Freight/Shipping charge for the order.
      - `shippingGlDescription` string — The GL account associated with the Freight/Shipping charge for the order.
      - `taxAmount` string — The amount of the Tax charged for the order.
      - `taxGlDescription` string — The GL account associated with the Tax charged for the order.
      - `transactionNumber` string — The Transaction Number for the order. Only required if updating an existing vendor order.
      - `vendorCode` string, required — The Code for the vendor associated with the order.
      - `vendorInvoiceNumber` string — The vendor's Invoice Number for the order.
  - `locationCode` string

## Other responses

- `400` — Validation Error
- `401` — Authorization
- `404` — electronic invoice not found
- `429` — Too Many Requests
- `500` — Unexpected Error
- `503` — Service Unavailable
- `504` — Timeout

---

[API](https://skmtc.net/crunchtime/apis/inventory-labor.md) · [All operations](https://skmtc.net/crunchtime/apis/inventory-labor/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crunchtime/inventory-labor/revisions/0af8e380ff2c/schema)