Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview


This structure represents the unique key fields associated with identifying an invoice . Invoices can be identified by InvoiceNumber or InvoiceUid. When specifying a PwsInvoiceRef as an input to a web service, you may specify one or both the InvoiceNumber and/or InvoiceUid. However, if you do specify both, they must both refer to the same Invoice or the Invoice reference will not be considered valid. When a PwsInvoiceRef is returned in the response to a web service, both the InvoiceNumber and InvoiceUid will be populated, and guaranteed to refer to a single invoice.

Format


Panel
titlePwsInvoiceRef
  • PwsInvoiceRef
    • InvoiceId: Int32
    • InvoiceNumber: String (20)
    • InvoiceUid: Int64

Elements


Element

Data Type

Required?

Default

Description

Sample Data

InvoiceId

Int32

On Insert: No

On Update: No


The Invoice Id is a unique identifier for an Invoice. For internal use only.


InvoiceNumber

String (20)

On Insert: Yes (if InvoiceUid is not supplied)

On Update: Yes (if InvoiceUid is not supplied)


The Invoice Number is a unique identifier for an Invoice

DRAFT00927

InvoiceUid

Int64

On Insert: Yes (if InvoiceNumber is not supplied)

On Update: Yes (if InvoiceNumber is not supplied)


The Invoice Uid is a unique and immutable identifier for an Invoice

1152921504607622580

Usage Example(s)


Code Block
languagexml
titleExample 01
collapsetrue
                        <InvoiceIdentity>
                           <InvoiceId i:nil="true"/>
                           <InvoiceNumber>DRAFT00927</InvoiceNumber>
                           <InvoiceUid>1152921504607622580</InvoiceUid>
                        </InvoiceIdentity>