Share via

<taSopSerial>*

  • Article

To use the default serial number, or to use serial number created by back office system, set the AUTOCREATESERIAL element of the <taSopLineIvcInsert> XML node to 1. To manually specify serial numbers, set the AUTOCREATESERIAL element to 0. Use the <taSopSerial> XML node to specify the serial number.

Element name

Data type

Length

Required

Default

Description

SOPTYPE

i4

4

Y

Not applicable

1=Quote;

2=Order;

3=Invoice;

4=Return;

5=Back order;

6=Fulfillment order

SOPNUMBE

string

21

Y

Not applicable

Document number

LNITMSEQ

i4

4

Y

Not applicable

Line item sequence

CMPNTSEQ

i4

4

N

0

Component sequence

QTYTYPE

i4

2

N

1

Quantity type:

1=Quantity on hand;

2=Quantity returned;

3=Quantity in use;

4=Quantity in service;

5=Quantity damaged

ITEMNMBR

string

30

Y

Not applicable

Item number

LOCNCODE

string

10

Y

Not applicable

If empty, default from IV is used

QUANTITY

number

21

N

1

Not used; always is set to 1 because serial numbers are a 1:1 relationship with the SOP line; multiple nodes would need to be used to pass in multiple serial numbers

BIN

string

15

N

<blank>

Bin; if multibins are enabled and AUTOCREATESERIAL=1, or SOPTYPE=4, this element is required; otherwise, its default is from IV00200

CREATEBIN

i4

1

N

0

Create bin:

0=No;

1=Yes--can create bin only when multibins are enabled and AUTOCREATESERIAL=1, or SOPTYPE=4

SERLNMBR

string

20

N

<blank>

Serial number

AUTOCREATESERIAL

i4

4

N

0

Autocreate serial number on the fly:

0=False;

1=True

DOCID

string

15

N

<blank>

Document ID; should match DOCIDpassed to taSopLineIvcInsert

DROPSHIP

i4

2

N

0

Drop ship flag;

1=Drop ship--should match Drop Ship_State to taSopLineIvcInsert

QTYFULFI

number

21

N

Default from setup

Quantity fulfilled; the sum of this field on all <taSopSerial> nodes being passed in should match QTYFULFI passed to <taSopLineIvcInsert>; if set to a value other than null, that value is used (this element is to help users because this node should only be called if quantities need fulfilling)

ALLOCATE

i4

2

N

0

Allocates quantities; should match ALLOCATE passed to <taSopLineIvcInsert>;

0=Use DOCID default;

1=Allocate quantities if DOCID allows (this is to help users because this node shouldn't be called if not fulfilling)

UpdateIfExists

i4

2

N

0

Used to add or modify existing components:

0=Add;

1=Modify existing

SERLNMBRToReplace

string

20

N

0

Previous serial number; used only if modifying an existing serial number

RequesterTrx

i4

2

N

0

Requester transaction:

0=False;

1=True (if True, it populates requester shadow table)

USRDEFND1

string

50

N

<blank>

User-defined field; developer use only

USRDEFND2

string

50

N

<blank>

User-defined field; developer use only

USRDEFND3

string

50

N

<blank>

User-defined field; developer use only

USRDEFND4

string

8000

N

<blank>

User-defined field; developer use only

USRDEFND5

string

8000

N

<blank>

User-defined field; developer use only

* The default action for the <taSopSerial> node is to use document exchange to provide update functionality. To use field level updates, set UpdateIfExists to 1.