Version: eXtendPS-SE 1.3.6 and above [The Invoice 1.0.0 service is applicable for 1.3.7 and above]
Audience: Administrator, Developer
Applies To: Invoice versions 0.0.1/1.0.0

Overview

eXtendPS-SE enables you to send customer invoice data using the PromoStandards Invoice specifications. For detailed service specifications, please refer to https://tools.promostandards.org/standards/services. To understand the data included in the eXtendPS-SE data return, please review the sample XML responses provided below.

Sample XML Response (Invoice 0.0.1):

Downloadable sample: Invoice 0.0.1 Response.xml
<?xml version="1.0" encoding="UTF-8"?> <Invoice xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">    <invoiceNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">Token1</invoiceNumber>
   <invoiceType xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">INVOICE</invoiceType>
   <invoiceDate xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1900-01-01T01:01:01.0000000+00:00</invoiceDate>
   <purchaseOrderNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">purchaseOrderNumber1</purchaseOrderNumber>
   <BillTo>
         <accountName>accountName1</accountName>
         <accountNumber>accountNumber1</accountNumber>
         <AddressLinesArray>AddressLinesArray1</AddressLinesArray>
         <AddressLinesArray>AddressLinesArray2</AddressLinesArray>
         <city>city1</city>
         <state>stat1</state>
         <postalCode>postalCode1</postalCode>
      </AccountInfo>
   </BillTo>
   <SoldTo>
   </SoldTo>
   <salesAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1</salesAmount>
   <totalAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1</totalAmount>
   <shippingAndHandlingAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1</shippingAndHandlingAmount>
   <advancePaymentAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1</advancePaymentAmount>
   <invoiceAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1</invoiceAmount>
   <InvoiceLineItemsArray>
         <invoiceLineItemId>1</invoiceLineItemId>
         <invoiceLineItemNumber>1</invoiceLineItemNumber>
         <purchaseOrderLineItemNumber>1</purchaseOrderLineItemNumber>
         <lineItemType>LINE ITEM</lineItemType>
         <orderedQuantity>1</orderedQuantity>
         <invoiceQuantity>1</invoiceQuantity>
         <backOrderedQuantity>1</backOrderedQuantity>
         <quantityUOM>quantityUOM1</quantityUOM>
         <lineItemDescription>lineItemDescription1</lineItemDescription>
         <unitPrice>1</unitPrice>
         <extendedPrice>1</extendedPrice>
         <lineItemTax>true</lineItemTax>
         <lineItemTaxType>SALES</lineItemTaxType>
      </InvoiceLineItem>
         <invoiceLineItemId>-2147483647</invoiceLineItemId>
         <invoiceLineItemNumber>-79228162514264337593543950335</invoiceLineItemNumber>
         <purchaseOrderLineItemNumber>-79228162514264337593543950335</purchaseOrderLineItemNumber>
         <lineItemType>TAX</lineItemType>
         <orderedQuantity>-79228162514264337593543950335</orderedQuantity>
         <invoiceQuantity>-79228162514264337593543950335</invoiceQuantity>
         <backOrderedQuantity>-79228162514264337593543950335</backOrderedQuantity>
         <quantityUOM>quantityUOM2</quantityUOM>
         <lineItemDescription>lineItemDescription2</lineItemDescription>
         <unitPrice>-79228162514264337593543950335</unitPrice>
         <extendedPrice>-79228162514264337593543950335</extendedPrice>
         <lineItemTax>false</lineItemTax>
         <lineItemTaxType>HST/GST</lineItemTaxType>
      </InvoiceLineItem>
   </InvoiceLineItemsArray>
   <SalesOrderNumberArray>
      <salesOrderNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">salesOrderNumber1</salesOrderNumber>
      <salesOrderNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">salesOrderNumber2</salesOrderNumber>
   </SalesOrderNumberArray>
</Invoice>    

Sample XML Response (Invoice 1.0.0):

Downloadable sample: Invoice 1.0.0 Response.xml
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tns="http://www.promostandards.org/WSDL/Invoice/1.0.0/" xmlns:ns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/" xmlns:ns1="http://www.codesynthesis.com/xmlns/xsstl">
  <s:Header xmlns:s="http://schemas.xmlsoap.org/soap/envelope/" />
  <soap:Body>
    <GetInvoicesResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/">
      <InvoiceArray>
        <Invoice>
          <invoiceNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">INV10000139</invoiceNumber>
          <invoiceType xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">INVOICE</invoiceType>
          <invoiceDate xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">2019-12-09</invoiceDate>
          <purchaseOrderNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">PUR6113456789876876545678765954</purchaseOrderNumber>
          <BillTo>
            <AccountInfo xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <accountName>Acera</accountName>
              <Address1>7th Avenue, 2nd street</Address1>
              <city>Los Angeles</city>
              <region>CA</region>
              <postalCode>90089</postalCode>
              <country>US</country>
              <phone>9876543210</phone>
            </AccountInfo>
          </BillTo>
          <SoldTo>
            <AccountInfo xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <accountName>eXtendTech</accountName>
              <Address1>7th Avenue, 2nd street</Address1>
              <city>Los Angeles</city>
              <region>CA</region>
              <postalCode>90089</postalCode>
              <country>US</country>
              <phone>9876543210</phone>
            </AccountInfo>
          </SoldTo>
          <paymentDueDate xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">2020-01-08</paymentDueDate>
          <currency xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">CAD</currency>
          <fob xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">01: San Francisco</fob>
          <salesAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">14.46</salesAmount>
          <shippingAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">2.40</shippingAmount>
          <handlingAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">2.40</handlingAmount>
          <taxAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">1.05</taxAmount>
          <invoiceAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">25.32</invoiceAmount>
          <advancePaymentAmount xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">.00</advancePaymentAmount>
          <invoiceAmountDue xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">0</invoiceAmountDue>
          <InvoiceLineItemsArray>
            <InvoiceLineItem xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <productId>121061</productId>
              <partId>snm-054X : 054X- XL-Deep Royal</partId>
              <chargeId>snm-054X : 054X- XL-Deep Royal</chargeId>
              <purchaseOrderLineItemNumber>1</purchaseOrderLineItemNumber>
              <orderedQuantity>2</orderedQuantity>
              <invoiceQuantity>2</invoiceQuantity>
              <quantityUOM>EA</quantityUOM>
              <lineItemDescription>check item desc</lineItemDescription>
              <unitPrice>7.23</unitPrice>
              <extendedPrice>8.50</extendedPrice>
              <distributorProductId>310995</distributorProductId>
              <distributorPartId>310995</distributorPartId>
            </InvoiceLineItem>
            <InvoiceLineItem xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <productId>121061</productId>
              <partId>snm-054X : 054X- XL-Deep Royal</partId>
              <chargeId>snm-054X : 054X- XL-Deep Royal</chargeId>
              <purchaseOrderLineItemNumber>22</purchaseOrderLineItemNumber>
              <orderedQuantity>1</orderedQuantity>
              <invoiceQuantity>1</invoiceQuantity>
              <quantityUOM>EA</quantityUOM>
              <lineItemDescription>this is sales description</lineItemDescription>
              <unitPrice>7.23</unitPrice>
              <extendedPrice>8.50</extendedPrice>
              <distributorProductId>310995</distributorProductId>
              <distributorPartId>310995</distributorPartId>
            </InvoiceLineItem>
          </InvoiceLineItemsArray>
          <SalesOrderNumberArray>
            <salesOrderNumber xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">SO6069371884</salesOrderNumber>
          </SalesOrderNumberArray>
          <TaxArray>
            <tax xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <taxType>SALES</taxType>
              <taxJurisdiction>CA</taxJurisdiction>
              <taxAmount>1.05</taxAmount>
            </tax>
            <tax xmlns="http://www.promostandards.org/WSDL/Invoice/1.0.0/SharedObjects/">
              <taxType>SALES</taxType>
              <taxJurisdiction>CA</taxJurisdiction>
              <taxAmount>.75</taxAmount>
            </tax>
          </TaxArray>
        </Invoice>
      </InvoiceArray>
    </GetInvoicesResponse>
  </soap:Body>
</soap:Envelope>

Field Mapping Details:

Image Placeholder

Including Sub-Customer Invoices

Invoice records for the customer which is specified on the associated eXtendPS-SE User Record will be sent in the invoice service's response by default. Invoices for sub-customers will not be sent in the response by default.

To include sub-customer invoices, enable the "ALLOW SUB-CUSTOMER'S INVOICES" checkbox on the eXtendPS-SE Invoice setup screen at eXtendTech → eXtendPS-SE → Invoice Setup.

Image Placeholder