DX STF Client API

GetInvoiceById

Invoice Requests

Invoice

The following routes are available for this service:
GET	/api/invoice/{Id}	Get specific invoice by Invoice Id

import datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DocumentIdentification:
    identifier: Optional[str] = None
    type: Optional[str] = None
    creation_date_and_time: datetime.datetime = datetime.datetime(1, 1, 1)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Identifier:
    authority: Optional[str] = None
    text: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ContactInformation:
    pass


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Partner:
    identifier: Optional[Identifier] = None
    contact_information: List[ContactInformation] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Header:
    document_identification: Optional[DocumentIdentification] = None
    sender: Optional[Partner] = None
    receiver: Optional[Partner] = None


class DocumentAction(str, Enum):
    ADD = 'ADD'
    CHANGE_BY_REFRESH = 'CHANGE_BY_REFRESH'
    DELETE = 'DELETE'
    REJECTED = 'REJECTED'


class DocumentStatus(str, Enum):
    ADDITIONAL_TRANSMISSION = 'ADDITIONAL_TRANSMISSION'
    COPY = 'COPY'
    ORIGINAL = 'ORIGINAL'


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AvpList:
    code: Optional[str] = None
    value: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class BaseDocument:
    currency_code: Optional[str] = None
    creation_date_time: datetime.datetime = datetime.datetime(1, 1, 1)
    document_action_code: Optional[DocumentAction] = None
    document_status_code: Optional[DocumentStatus] = None
    document_structure_version: Optional[str] = None
    last_update_date_time: Optional[datetime.datetime] = None
    revision_number: Optional[int] = None
    avp_list: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Ecom_PartyIdentificationType:
    gln: Optional[str] = None
    name: Optional[str] = None
    additional_party_identification: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class CommunicationChannel:
    communication_channel_code: Optional[str] = None
    communication_channel_name: Optional[str] = None
    communication_value: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Contact:
    contact_type_code: Optional[str] = None
    person_name: Optional[str] = None
    department_name: Optional[str] = None
    job_title: Optional[str] = None
    responsibility: Optional[str] = None
    communication_channel: List[CommunicationChannel] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Address:
    street_address_one: Optional[str] = None
    street_address_two: Optional[str] = None
    street_address_three: Optional[str] = None
    city: Optional[str] = None
    postal_code: Optional[str] = None
    province_code: Optional[str] = None
    country_code: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class FinancialRoutingNumber:
    number: Optional[str] = None
    number_type_code: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class FinancialAccount:
    number: Optional[str] = None
    number_type_code: Optional[str] = None
    name: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class FinancialInstitutionInformation:
    financial_institution_branch_name: Optional[str] = None
    financial_institution_name: Optional[str] = None
    financial_routing_number: Optional[FinancialRoutingNumber] = None
    financial_account: Optional[FinancialAccount] = None
    swift_code: Optional[str] = None
    exporters_code: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalParty(Ecom_PartyIdentificationType):
    contact: List[Contact] = field(default_factory=list)
    address: Optional[Address] = None
    communication_channel: List[AvpList] = field(default_factory=list)
    financial_institution_information: Optional[FinancialInstitutionInformation] = None
    duty_fee_tax_registration: Optional[str] = None
    entity_identification: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Invoice:
    creation_date: Optional[datetime.datetime] = None
    revision_number: Optional[int] = None
    entity_identification: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class DocumentReference:
    creation_date_time: Optional[datetime.datetime] = None
    revision_number: Optional[int] = None
    line_item_number: Optional[int] = None
    entity_identification: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ShipmentTransportationInformation:
    carrier: Optional[TransactionalParty] = None
    freight_forwarder: Optional[TransactionalParty] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Quantity:
    value: Optional[Decimal] = None
    measurement_unit_code: Optional[str] = None
    code_list_version: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItem:
    measurement_unit_code: Optional[str] = None
    measurement_type: Optional[str] = None
    measurement_value: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class SerialNumberRange:
    maximum_value: Optional[str] = None
    minimum_value: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItemDimension:
    measurement_unit_code: Optional[str] = None
    depth: Optional[str] = None
    height: Optional[str] = None
    width: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItemLogisticUnitInformation:
    number_of_layers: Optional[int] = None
    number_of_units_per_layer: Optional[int] = None
    number_of_units_per_pallet: Optional[int] = None
    packaging_terms: Optional[str] = None
    package_type_code: Optional[str] = None
    maximum_stacking_factor: Optional[int] = None
    returnable_package_transport_cost_payment: Optional[str] = None
    dimensions_of_logistic_unit: List[TransactionalItemDimension] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItemDataCarrierAndIdentification:
    gs1_transactional_item_identification_key: Optional[str] = None
    data_carrier: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TradeItemWaste:
    waste_identification: Optional[str] = None
    type_of_waste: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItemOrganicInformation:
    is_trade_item_organic: Optional[bool] = None
    organic_certification: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalItemData:
    available_for_sale_date: Optional[datetime.datetime] = None
    batch_number: Optional[str] = None
    best_before_date: Optional[datetime.datetime] = None
    country_of_origin: Optional[str] = None
    item_expiration_date: Optional[datetime.datetime] = None
    lot_number: Optional[str] = None
    packaging_date: Optional[datetime.datetime] = None
    production_date: Optional[datetime.datetime] = None
    product_quality_indication: Optional[str] = None
    sell_by_date: Optional[datetime.datetime] = None
    serial_number: List[str] = field(default_factory=list)
    shelf_life: Optional[str] = None
    trade_item_quantity: Optional[int] = None
    item_in_contact_with_food_product: Optional[bool] = None
    transactional_item_weight: List[TransactionalItem] = field(default_factory=list)
    transactional_item_volume: List[TransactionalItem] = field(default_factory=list)
    serial_number_range: List[SerialNumberRange] = field(default_factory=list)
    transactional_item_dimensions: List[TransactionalItemDimension] = field(default_factory=list)
    transactional_item_logistic_unit_information: Optional[TransactionalItemLogisticUnitInformation] = None
    transactional_item_data_carrier_and_identification: Optional[TransactionalItemDataCarrierAndIdentification] = None
    trade_item_waste: List[TradeItemWaste] = field(default_factory=list)
    transactional_item_organic_information: Optional[TransactionalItemOrganicInformation] = None
    avp_list: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Colour:
    colour_code: Optional[str] = None
    colour_description: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Size:
    descriptive_size: Optional[str] = None
    size_code: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TradeItemClassification:
    gpc_category_code: Optional[str] = None
    additional_trade_item_classification_code: List[AvpList] = field(default_factory=list)
    gpc_category_name: Optional[str] = None
    gpc_attribute: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TransactionalTradeItem:
    gtin: Optional[str] = None
    additional_trade_item_identification: List[AvpList] = field(default_factory=list)
    trade_item_quantity: Optional[Decimal] = None
    trade_item_description: Optional[str] = None
    product_variant_identifier: Optional[str] = None
    item_type_code: Optional[str] = None
    trade_item_data_owner: Optional[str] = None
    butter_fat_reference: Optional[str] = None
    transactional_item_data: List[TransactionalItemData] = field(default_factory=list)
    colour: List[Colour] = field(default_factory=list)
    size: Optional[Size] = None
    trade_item_classification: Optional[TradeItemClassification] = None
    avp_list: List[AvpList] = field(default_factory=list)


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class TaxInformation:
    tax_percentage: Optional[Decimal] = None
    tax_amount: Optional[Decimal] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class AllowanceCharge:
    allowance_charge_amount: Optional[Decimal] = None
    allowance_charge_percentage: Optional[Decimal] = None
    allowance_charge_type: Optional[str] = None
    allowance_or_charge_type: Optional[str] = None
    amount_per_unit: Optional[Decimal] = None
    base_amount: Optional[Decimal] = None
    base_number_of_units: Optional[str] = None
    bracket_identifier: Optional[str] = None
    effective_date_type: Optional[datetime.datetime] = None
    sequence_number: Optional[str] = None
    settlement_type: Optional[str] = None
    special_service_type: Optional[str] = None
    allowance_charge_description: Optional[str] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InvoiceAllowanceCharge:
    allowance_charge: Optional[AllowanceCharge] = None
    levied_duty_fee_tax: Optional[TaxInformation] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class Extension:
    pass


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InvoiceLineItem:
    line_number: Optional[int] = None
    parent_line_item_number: Optional[str] = None
    invoiced_quantity: Optional[Quantity] = None
    transactional_trade_item: Optional[TransactionalTradeItem] = None
    item_price_base_quantity: Optional[Decimal] = None
    retail_price_excluding_excise: Optional[Decimal] = None
    recommended_retail_price: Optional[Decimal] = None
    tax_information: Optional[TaxInformation] = None
    amount_exclusive_allowances_charges: Optional[Decimal] = None
    amount_inclusive_allowances_charges: Optional[Decimal] = None
    item_price_exclusive_allowances_charges: Optional[Decimal] = None
    item_price_inclusive_allowances_charges: Optional[Decimal] = None
    trade_agreement: Optional[str] = None
    delivery_note: Optional[str] = None
    promotional_deal: Optional[DocumentReference] = None
    invoice_allowance_charge: List[InvoiceAllowanceCharge] = field(default_factory=list)
    extended_properties: Optional[Extension] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InvoiceTotals:
    base_amount: Optional[Decimal] = None
    prepaid_amount: Optional[Decimal] = None
    prepaid_amount_date: Optional[datetime.datetime] = None
    total_amount_invoice_allowances_charges: Optional[Decimal] = None
    total_line_amount_inclusive_allowances_charges: Optional[Decimal] = None
    total_tax_amount: Optional[Decimal] = None
    total_invoice_amount: Optional[Decimal] = None
    total_invoice_amount_payable: Optional[Decimal] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InvoiceClass(BaseDocument):
    country_of_supply_of_goods: Optional[str] = None
    buyer: Optional[TransactionalParty] = None
    seller: Optional[TransactionalParty] = None
    payee: Optional[TransactionalParty] = None
    payer: Optional[TransactionalParty] = None
    ship_from: Optional[TransactionalParty] = None
    ship_to: Optional[TransactionalParty] = None
    ultimate_consignee: Optional[TransactionalParty] = None
    supplier_account_receivable: Optional[str] = None
    invoice_identification: Optional[str] = None
    invoice: Optional[Invoice] = None
    sales_order: Optional[DocumentReference] = None
    purchase_order: Optional[DocumentReference] = None
    delivery_note: Optional[DocumentReference] = None
    trade_agreement: Optional[DocumentReference] = None
    shipment_transportation_information: Optional[ShipmentTransportationInformation] = None
    payment_terms: Optional[str] = None
    invoice_line_item: List[InvoiceLineItem] = field(default_factory=list)
    invoice_totals: Optional[InvoiceTotals] = None


@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class InvoiceMessage:
    header: Optional[Header] = None
    invoice: Optional[InvoiceClass] = None


# @Api(Description="Invoice")
# @ApiResponse(Description="Invoice data", IsDefaultResponse=true, StatusCode=200)
# @ApiResponse(Description="No Content", ResponseType=typeof(IReturnVoid), StatusCode=204)
# @ApiResponse(Description="Specified argument was out of the range of valid values.", ResponseType=typeof(ArgumentOutOfRangeException), StatusCode=400)
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class GetInvoiceById(IGetDocumentById):
    """
    Invoice
    """

    # @ApiMember(ExcludeInSchema=true, ParameterType="path")
    id: Optional[str] = None

Python GetInvoiceById DTOs

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /api/invoice/{Id} HTTP/1.1 
Host: stf-api-uat.data-xchange.co.za 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<InvoiceMessage xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/DX.STF.Models.Dto.GS1">
  <Header>
    <documentIdentification>
      <creationDateAndTime>0001-01-01T00:00:00</creationDateAndTime>
      <identifier>String</identifier>
      <type>String</type>
    </documentIdentification>
    <receiver>
      <contactInformation>
        <ContactInformation />
      </contactInformation>
      <identifier>
        <authority>String</authority>
        <text>String</text>
      </identifier>
    </receiver>
    <sender>
      <contactInformation>
        <ContactInformation />
      </contactInformation>
      <identifier>
        <authority>String</authority>
        <text>String</text>
      </identifier>
    </sender>
  </Header>
  <Invoice>
    <AvpList>
      <AvpList>
        <Code>String</Code>
        <Value>String</Value>
      </AvpList>
    </AvpList>
    <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
    <CurrencyCode>String</CurrencyCode>
    <DocumentActionCode>ADD</DocumentActionCode>
    <DocumentStatusCode>ADDITIONAL_TRANSMISSION</DocumentStatusCode>
    <DocumentStructureVersion>String</DocumentStructureVersion>
    <LastUpdateDateTime>0001-01-01T00:00:00</LastUpdateDateTime>
    <RevisionNumber>0</RevisionNumber>
    <Buyer>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Buyer>
    <CountryOfSupplyOfGoods>String</CountryOfSupplyOfGoods>
    <DeliveryNote>
      <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
      <EntityIdentification>String</EntityIdentification>
      <LineItemNumber>0</LineItemNumber>
      <RevisionNumber>0</RevisionNumber>
    </DeliveryNote>
    <Invoice>
      <CreationDate>0001-01-01T00:00:00</CreationDate>
      <EntityIdentification>String</EntityIdentification>
      <RevisionNumber>0</RevisionNumber>
    </Invoice>
    <InvoiceIdentification>String</InvoiceIdentification>
    <InvoiceLineItem>
      <InvoiceLineItem>
        <AmountExclusiveAllowancesCharges>0</AmountExclusiveAllowancesCharges>
        <AmountInclusiveAllowancesCharges>0</AmountInclusiveAllowancesCharges>
        <DeliveryNote>String</DeliveryNote>
        <ExtendedProperties />
        <InvoiceAllowanceCharge>
          <InvoiceAllowanceCharge>
            <AllowanceCharge>
              <AllowanceChargeAmount>0</AllowanceChargeAmount>
              <AllowanceChargeDescription>String</AllowanceChargeDescription>
              <AllowanceChargePercentage>0</AllowanceChargePercentage>
              <AllowanceChargeType>String</AllowanceChargeType>
              <AllowanceOrChargeType>String</AllowanceOrChargeType>
              <AmountPerUnit>0</AmountPerUnit>
              <BaseAmount>0</BaseAmount>
              <BaseNumberOfUnits>String</BaseNumberOfUnits>
              <BracketIdentifier>String</BracketIdentifier>
              <EffectiveDateType>0001-01-01T00:00:00</EffectiveDateType>
              <SequenceNumber>String</SequenceNumber>
              <SettlementType>String</SettlementType>
              <SpecialServiceType>String</SpecialServiceType>
            </AllowanceCharge>
            <LeviedDutyFeeTax>
              <TaxAmount>0</TaxAmount>
              <TaxPercentage>0</TaxPercentage>
            </LeviedDutyFeeTax>
          </InvoiceAllowanceCharge>
        </InvoiceAllowanceCharge>
        <InvoicedQuantity>
          <CodeListVersion>String</CodeListVersion>
          <MeasurementUnitCode>String</MeasurementUnitCode>
          <Value>0</Value>
        </InvoicedQuantity>
        <ItemPriceBaseQuantity>0</ItemPriceBaseQuantity>
        <ItemPriceExclusiveAllowancesCharges>0</ItemPriceExclusiveAllowancesCharges>
        <ItemPriceInclusiveAllowancesCharges>0</ItemPriceInclusiveAllowancesCharges>
        <LineNumber>0</LineNumber>
        <ParentLineItemNumber>String</ParentLineItemNumber>
        <PromotionalDeal>
          <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
          <EntityIdentification>String</EntityIdentification>
          <LineItemNumber>0</LineItemNumber>
          <RevisionNumber>0</RevisionNumber>
        </PromotionalDeal>
        <RecommendedRetailPrice>0</RecommendedRetailPrice>
        <RetailPriceExcludingExcise>0</RetailPriceExcludingExcise>
        <TaxInformation>
          <TaxAmount>0</TaxAmount>
          <TaxPercentage>0</TaxPercentage>
        </TaxInformation>
        <TradeAgreement>String</TradeAgreement>
        <TransactionalTradeItem>
          <AdditionalTradeItemIdentification>
            <AvpList>
              <Code>String</Code>
              <Value>String</Value>
            </AvpList>
          </AdditionalTradeItemIdentification>
          <AvpList>
            <AvpList>
              <Code>String</Code>
              <Value>String</Value>
            </AvpList>
          </AvpList>
          <ButterFatReference>String</ButterFatReference>
          <Colour>
            <Colour>
              <ColourCode>String</ColourCode>
              <ColourDescription>String</ColourDescription>
            </Colour>
          </Colour>
          <Gtin>String</Gtin>
          <ItemTypeCode>String</ItemTypeCode>
          <ProductVariantIdentifier>String</ProductVariantIdentifier>
          <Size>
            <DescriptiveSize>String</DescriptiveSize>
            <SizeCode>String</SizeCode>
          </Size>
          <TradeItemClassification>
            <AdditionalTradeItemClassificationCode>
              <AvpList>
                <Code>String</Code>
                <Value>String</Value>
              </AvpList>
            </AdditionalTradeItemClassificationCode>
            <GpcAttribute>
              <AvpList>
                <Code>String</Code>
                <Value>String</Value>
              </AvpList>
            </GpcAttribute>
            <GpcCategoryCode>String</GpcCategoryCode>
            <GpcCategoryName>String</GpcCategoryName>
          </TradeItemClassification>
          <TradeItemDataOwner>String</TradeItemDataOwner>
          <TradeItemDescription>String</TradeItemDescription>
          <TradeItemQuantity>0</TradeItemQuantity>
          <TransactionalItemData>
            <TransactionalItemData>
              <AvailableForSaleDate>0001-01-01T00:00:00</AvailableForSaleDate>
              <AvpList>
                <AvpList>
                  <Code>String</Code>
                  <Value>String</Value>
                </AvpList>
              </AvpList>
              <BatchNumber>String</BatchNumber>
              <BestBeforeDate>0001-01-01T00:00:00</BestBeforeDate>
              <CountryOfOrigin>String</CountryOfOrigin>
              <ItemExpirationDate>0001-01-01T00:00:00</ItemExpirationDate>
              <ItemInContactWithFoodProduct>false</ItemInContactWithFoodProduct>
              <LotNumber>String</LotNumber>
              <PackagingDate>0001-01-01T00:00:00</PackagingDate>
              <ProductQualityIndication>String</ProductQualityIndication>
              <ProductionDate>0001-01-01T00:00:00</ProductionDate>
              <SellByDate>0001-01-01T00:00:00</SellByDate>
              <SerialNumber xmlns:d8p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
                <d8p1:string>String</d8p1:string>
              </SerialNumber>
              <SerialNumberRange>
                <SerialNumberRange>
                  <MaximumValue>String</MaximumValue>
                  <MinimumValue>String</MinimumValue>
                </SerialNumberRange>
              </SerialNumberRange>
              <ShelfLife>String</ShelfLife>
              <TradeItemQuantity>0</TradeItemQuantity>
              <TradeItemWaste>
                <TradeItemWaste>
                  <TypeOfWaste>
                    <AvpList>
                      <Code>String</Code>
                      <Value>String</Value>
                    </AvpList>
                  </TypeOfWaste>
                  <WasteIdentification>String</WasteIdentification>
                </TradeItemWaste>
              </TradeItemWaste>
              <TransactionalItemDataCarrierAndIdentification>
                <DataCarrier>String</DataCarrier>
                <Gs1TransactionalItemIdentificationKey>String</Gs1TransactionalItemIdentificationKey>
              </TransactionalItemDataCarrierAndIdentification>
              <TransactionalItemDimensions>
                <TransactionalItemDimension>
                  <Depth>String</Depth>
                  <Height>String</Height>
                  <MeasurementUnitCode>String</MeasurementUnitCode>
                  <Width>String</Width>
                </TransactionalItemDimension>
              </TransactionalItemDimensions>
              <TransactionalItemLogisticUnitInformation>
                <DimensionsOfLogisticUnit>
                  <TransactionalItemDimension>
                    <Depth>String</Depth>
                    <Height>String</Height>
                    <MeasurementUnitCode>String</MeasurementUnitCode>
                    <Width>String</Width>
                  </TransactionalItemDimension>
                </DimensionsOfLogisticUnit>
                <MaximumStackingFactor>0</MaximumStackingFactor>
                <NumberOfLayers>0</NumberOfLayers>
                <NumberOfUnitsPerLayer>0</NumberOfUnitsPerLayer>
                <NumberOfUnitsPerPallet>0</NumberOfUnitsPerPallet>
                <PackageTypeCode>String</PackageTypeCode>
                <PackagingTerms>String</PackagingTerms>
                <ReturnablePackageTransportCostPayment>String</ReturnablePackageTransportCostPayment>
              </TransactionalItemLogisticUnitInformation>
              <TransactionalItemOrganicInformation>
                <IsTradeItemOrganic>false</IsTradeItemOrganic>
                <OrganicCertification>String</OrganicCertification>
              </TransactionalItemOrganicInformation>
              <TransactionalItemVolume>
                <TransactionalItem>
                  <MeasurementType>String</MeasurementType>
                  <MeasurementUnitCode>String</MeasurementUnitCode>
                  <MeasurementValue>String</MeasurementValue>
                </TransactionalItem>
              </TransactionalItemVolume>
              <TransactionalItemWeight>
                <TransactionalItem>
                  <MeasurementType>String</MeasurementType>
                  <MeasurementUnitCode>String</MeasurementUnitCode>
                  <MeasurementValue>String</MeasurementValue>
                </TransactionalItem>
              </TransactionalItemWeight>
            </TransactionalItemData>
          </TransactionalItemData>
        </TransactionalTradeItem>
      </InvoiceLineItem>
    </InvoiceLineItem>
    <InvoiceTotals>
      <BaseAmount>0</BaseAmount>
      <PrepaidAmount>0</PrepaidAmount>
      <PrepaidAmountDate>0001-01-01T00:00:00</PrepaidAmountDate>
      <TotalAmountInvoiceAllowancesCharges>0</TotalAmountInvoiceAllowancesCharges>
      <TotalInvoiceAmount>0</TotalInvoiceAmount>
      <TotalInvoiceAmountPayable>0</TotalInvoiceAmountPayable>
      <TotalLineAmountInclusiveAllowancesCharges>0</TotalLineAmountInclusiveAllowancesCharges>
      <TotalTaxAmount>0</TotalTaxAmount>
    </InvoiceTotals>
    <Payee>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Payee>
    <Payer>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Payer>
    <PaymentTerms>String</PaymentTerms>
    <PurchaseOrder>
      <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
      <EntityIdentification>String</EntityIdentification>
      <LineItemNumber>0</LineItemNumber>
      <RevisionNumber>0</RevisionNumber>
    </PurchaseOrder>
    <SalesOrder>
      <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
      <EntityIdentification>String</EntityIdentification>
      <LineItemNumber>0</LineItemNumber>
      <RevisionNumber>0</RevisionNumber>
    </SalesOrder>
    <Seller>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </Seller>
    <ShipFrom>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </ShipFrom>
    <ShipTo>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </ShipTo>
    <ShipmentTransportationInformation>
      <Carrier>
        <AdditionalPartyIdentification>
          <AvpList>
            <Code>String</Code>
            <Value>String</Value>
          </AvpList>
        </AdditionalPartyIdentification>
        <Gln>String</Gln>
        <Name>String</Name>
        <Address>
          <City>String</City>
          <CountryCode>String</CountryCode>
          <PostalCode>String</PostalCode>
          <ProvinceCode>String</ProvinceCode>
          <StreetAddressOne>String</StreetAddressOne>
          <StreetAddressThree>String</StreetAddressThree>
          <StreetAddressTwo>String</StreetAddressTwo>
        </Address>
        <CommunicationChannel>
          <AvpList>
            <Code>String</Code>
            <Value>String</Value>
          </AvpList>
        </CommunicationChannel>
        <Contact>
          <Contact>
            <CommunicationChannel>
              <CommunicationChannel>
                <CommunicationChannelCode>String</CommunicationChannelCode>
                <CommunicationChannelName>String</CommunicationChannelName>
                <CommunicationValue>String</CommunicationValue>
              </CommunicationChannel>
            </CommunicationChannel>
            <ContactTypeCode>String</ContactTypeCode>
            <DepartmentName>String</DepartmentName>
            <JobTitle>String</JobTitle>
            <PersonName>String</PersonName>
            <Responsibility>String</Responsibility>
          </Contact>
        </Contact>
        <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
        <EntityIdentification>String</EntityIdentification>
        <FinancialInstitutionInformation>
          <ExportersCode>String</ExportersCode>
          <FinancialAccount>
            <Name>String</Name>
            <Number>String</Number>
            <NumberTypeCode>String</NumberTypeCode>
          </FinancialAccount>
          <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
          <FinancialInstitutionName>String</FinancialInstitutionName>
          <FinancialRoutingNumber>
            <Number>String</Number>
            <NumberTypeCode>String</NumberTypeCode>
          </FinancialRoutingNumber>
          <SwiftCode>String</SwiftCode>
        </FinancialInstitutionInformation>
      </Carrier>
      <FreightForwarder>
        <AdditionalPartyIdentification>
          <AvpList>
            <Code>String</Code>
            <Value>String</Value>
          </AvpList>
        </AdditionalPartyIdentification>
        <Gln>String</Gln>
        <Name>String</Name>
        <Address>
          <City>String</City>
          <CountryCode>String</CountryCode>
          <PostalCode>String</PostalCode>
          <ProvinceCode>String</ProvinceCode>
          <StreetAddressOne>String</StreetAddressOne>
          <StreetAddressThree>String</StreetAddressThree>
          <StreetAddressTwo>String</StreetAddressTwo>
        </Address>
        <CommunicationChannel>
          <AvpList>
            <Code>String</Code>
            <Value>String</Value>
          </AvpList>
        </CommunicationChannel>
        <Contact>
          <Contact>
            <CommunicationChannel>
              <CommunicationChannel>
                <CommunicationChannelCode>String</CommunicationChannelCode>
                <CommunicationChannelName>String</CommunicationChannelName>
                <CommunicationValue>String</CommunicationValue>
              </CommunicationChannel>
            </CommunicationChannel>
            <ContactTypeCode>String</ContactTypeCode>
            <DepartmentName>String</DepartmentName>
            <JobTitle>String</JobTitle>
            <PersonName>String</PersonName>
            <Responsibility>String</Responsibility>
          </Contact>
        </Contact>
        <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
        <EntityIdentification>String</EntityIdentification>
        <FinancialInstitutionInformation>
          <ExportersCode>String</ExportersCode>
          <FinancialAccount>
            <Name>String</Name>
            <Number>String</Number>
            <NumberTypeCode>String</NumberTypeCode>
          </FinancialAccount>
          <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
          <FinancialInstitutionName>String</FinancialInstitutionName>
          <FinancialRoutingNumber>
            <Number>String</Number>
            <NumberTypeCode>String</NumberTypeCode>
          </FinancialRoutingNumber>
          <SwiftCode>String</SwiftCode>
        </FinancialInstitutionInformation>
      </FreightForwarder>
    </ShipmentTransportationInformation>
    <SupplierAccountReceivable>String</SupplierAccountReceivable>
    <TradeAgreement>
      <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
      <EntityIdentification>String</EntityIdentification>
      <LineItemNumber>0</LineItemNumber>
      <RevisionNumber>0</RevisionNumber>
    </TradeAgreement>
    <UltimateConsignee>
      <AdditionalPartyIdentification>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </AdditionalPartyIdentification>
      <Gln>String</Gln>
      <Name>String</Name>
      <Address>
        <City>String</City>
        <CountryCode>String</CountryCode>
        <PostalCode>String</PostalCode>
        <ProvinceCode>String</ProvinceCode>
        <StreetAddressOne>String</StreetAddressOne>
        <StreetAddressThree>String</StreetAddressThree>
        <StreetAddressTwo>String</StreetAddressTwo>
      </Address>
      <CommunicationChannel>
        <AvpList>
          <Code>String</Code>
          <Value>String</Value>
        </AvpList>
      </CommunicationChannel>
      <Contact>
        <Contact>
          <CommunicationChannel>
            <CommunicationChannel>
              <CommunicationChannelCode>String</CommunicationChannelCode>
              <CommunicationChannelName>String</CommunicationChannelName>
              <CommunicationValue>String</CommunicationValue>
            </CommunicationChannel>
          </CommunicationChannel>
          <ContactTypeCode>String</ContactTypeCode>
          <DepartmentName>String</DepartmentName>
          <JobTitle>String</JobTitle>
          <PersonName>String</PersonName>
          <Responsibility>String</Responsibility>
        </Contact>
      </Contact>
      <DutyFeeTaxRegistration>String</DutyFeeTaxRegistration>
      <EntityIdentification>String</EntityIdentification>
      <FinancialInstitutionInformation>
        <ExportersCode>String</ExportersCode>
        <FinancialAccount>
          <Name>String</Name>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialAccount>
        <FinancialInstitutionBranchName>String</FinancialInstitutionBranchName>
        <FinancialInstitutionName>String</FinancialInstitutionName>
        <FinancialRoutingNumber>
          <Number>String</Number>
          <NumberTypeCode>String</NumberTypeCode>
        </FinancialRoutingNumber>
        <SwiftCode>String</SwiftCode>
      </FinancialInstitutionInformation>
    </UltimateConsignee>
  </Invoice>
</InvoiceMessage>