h.Financing Terms
The Payment Terms are agreed by the partner and Cisco and are set and stored with the Finance Terms in the General Agreement. Providing this information is optional, as evidenced by a cardinality value of 0..n in the table that follows.
Partners need to provide a value in the PIP due to cardinality rules. This fact is evidenced by a cardinality value of 0..1, also in the table. Please send the value as “Mutually Defined/Determined by TPA”.
Table : Financing Terms
No.
|
Cardinality
|
PIP Element
|
Notes
|
Field Length
|
78
|
0..n
|
|--FinancingTerms
|
Required tag
|
N/A
|
79
|
0..1
|
| |--GlobalFinanceTermsCode
|
Send the value “Mutually Defined/Determined by TPA”.
|
N/A
| i.Order Shipping Information i.Request Ship Date
Partners may request a ship date for the PO. If a requested ship date is not provided or has expired, Cisco defaults the requested ship date to the current date + 1.
Cisco booking policy requires that all orders have a requested ship date within 90 days of the date of submission. Orders with any lines having a requested ship date outside of 90 days of the submission date are rejected.
Note: Though a requested ship date is not applicable to service orders, partners have to provide any date value for the Product Line Item. Requested ship date is mandatory data according to PIP 3A4’s requirements.
ii.Shipping Address
A valid shipping address is required on the 3A4 XML Purchase Order. This fact is evidenced by cardinality values of 1 in the table that follows. If partners do not provide a shipping address at either the Product Line level or the Purchase Order level, Cisco will reject the Purchase Order.
A valid shipping address must contain at least address line 1, the city, and the country code. Postal code (ZIP code) and state/province are required for American, Canadian, and European addresses.
If all ordered lines are to ship to one address, they can provide the shipping address at the PurchaseOrder level. In this case, if partners have not provided line level addresses, Cisco will make every effort to cascade this header level ShipTo address to the line level shipTo address. Partners will send in ShipTo address freeform text rather than the ShipTo address ID. We recommend that partners not include a Ship To address ID, as this may result in delays in the order process.
If the partner submits data at the ProductLineItem level, Cisco will ship this line to the given address. The line level addresses will override any order level addresses provided on the same 3A4 PO request.
Cisco validates provided ship to and end user addresses against country postal guidelines for completeness and validity. Addresses that do not conform to the below guidelines may cause the submitted order to require manual review by Cisco’s order processing team. This can delay subsequent order cycles.
Please ensure that you consider the following guidelines when developing your ship to and end user address mapping:
Insert street address in line 1, unless additional department name or building information is required for delivery.
If additional company department or building information needs to be included, please use address line 1 (and 2 if necessary). Street address should be placed in the next address line.
Insert contact names and contact details in the relevant contact elements, not in the address line fields.
Any additional delivery instructions should be inserted in the packing slip or carton notes fields. More information on this can be found in Section 4.12, Shipping and Packaging Notes.
PO Box references should not be used in ship to addresses.
RegionName (state/province) is mandatory for Japan, US, or Canadian addresses.
Known limitation
The actual order ship-to date information is not known at the time of the PO Ack response. To avoid delaying the PO Ack response until full processing is done, Cisco will send the PO Ack with no shipTo information at the header level.
The tables that follow provide required, optional, and non-required data for the Shipping Address. Request Ship Date information is also captured.
Table : Required, Optional, and Non Required Data for Shipping Address
1Country
|
ISO Code
|
Ship to Company Name
|
Address Line 1
|
Address Line 2
|
Address Line 3
|
City
|
State/
Province/ Region
|
Country
|
Postal Code
|
Australia
|
AU
|
|
Street address is mandatory. See above guidelines for placement
|
|
O
|
|
|
Brazil
|
BR
|
|
|
O
|
|
|
Canada
|
CA
|
|
|
|
|
|
China
|
CN
|
|
|
O
|
|
|
France
|
FR
|
|
|
O
|
|
|
Germany
|
DE
|
|
|
O
|
|
|
Italy
|
IT
|
|
|
O
|
|
|
Japan
|
JP
|
|
|
|
|
|
UK
|
GB
|
|
|
O
|
|
|
USA
|
US
|
|
|
|
|
|
Other Countries
|
-
|
|
|
O
|
|
|
() is a required data for a valid address; it is commonly used in that country.
(O) is a optional data for a valid address; it is not part of common address format for that country.
(N/A) data is not required for a valid address; it is not used in that country.
Refer to appendix C for complete list of such rules.
Note: customer name, country and address line 1 are mandatory
If partners do not provide shipping address at either the Product Line level or the Purchase Order level, Cisco will run defaulting rules as specified in Appendix C: Address Processing to make every effort to process the order. If Cisco is unable to work through any of the defaulting rules, Cisco will reject the order.
Canadian Tax Code is derived from the Ship To address by Tax Services and applied accordingly (if the ship to address is in Canada) later in the process. This default applies regardless of whether the partner has provided the code in the order XML.
Table : PIP 3A4 V02.00.00 - Line Level Requested Ship Date and Address
No.
|
Cardinality
|
PIP Element
|
Notes
|
Field Length
|
305
|
1
|
| |--requestedEvent.TransportationEvent
|
Required tag
|
N/A
|
306
|
1
|
| | |--DateStamp
|
The date a transportation event is requested to occur.
Date in Zulu time format.
Example: “20031010T080034.345Z”
Invalid value: 00000000Z. If provided, the system will default to Submit Date +1
|
Zulu time format
|
307
|
1
|
| | |--GlobalTransportEventCode
|
Send the values “Ship” “Dock” or “Pick-up”
Ship: The event representing when the product is requested to ship.
Dock: The event representing when the product should arrive on the recipient's dock.
Pickup: The event representing when the product is scheduled to be picked up from the shipper's dock.
If the sent values are not what is set-up by Cisco for the Customer. Cisco will override the same with the value derived
|
N/A
|
314
|
0..1
|
| |--shipTo.PartnerDescription
|
Required tag
|
N/A
|
315
|
1
|
| | |--BusinessDescription
|
Required tag
|
N/A
|
316
|
0..1
|
| | | |--businessName.FreeFormText
|
Ship-To customer name for this line.
Example: Global Router Systems, Inc.
|
CHAR(50)
|
323
|
1
|
| | |--GlobalPartnerClassificationCode
|
Enter one of following:
“End User”
“Distributor”
“Reseller”
|
N/A
|
324
|
0..1
|
| | |--PhysicalAddress
|
Required tag
|
N/A
|
325
|
0..1
|
| | | |--addressLine1.FreeFormText
|
Street address of Ship-To company.
In order to prevent CPE tasks, systems expects the Name, addressLine1 and Country for address creation or validation.
Field should not be used for order notes. If additional department or building info is required, place here. Move street address to next addressline.
Example: “170 WEST TASMAN DRIVE”
|
CHAR(240)
|
326
|
0..1
|
| | | |--addressLine2.FreeFormText
|
Street address of Ship-To company. If additional department or building info is required place here. Move street address to the next addressline.
|
CHAR(240)
|
327
|
0..1
|
| | | |--addressLine3.FreeFormText
|
Street address of Ship-To company (if not already supplied in addressline 1 or 2.
|
CHAR(240)
|
328
|
0..1
|
| | | |--cityName.FreeFormText
|
City of street address of Ship-To company.
Example: “San Jose”
|
CHAR(60)
|
329
|
0..1
|
| | | |--GlobalCountryCode
|
ISO country code of street address of the ship-to company. UPPERCASE only.
Example: “US”
Depending on country, system may expect other mandatory address elements like City and/or State
|
CHAR(2)
|
330
|
0..1
|
| | | | -- GlobalLocationIdentifier
|
If partners provide a valid location identifier, system uses this instead of the address on the PO. However a known system limitation is that an invalid ID on this tag results in an order rejection
|
Char (13)
|
331
|
0..1
|
| | | |--NationalPostalCode
|
If partner plans to use 10 digit code for American addresses, omit the hyphen “-“ character. Hyphen “-“ character not allowed.
|
CHAR(9)
|
332
|
0..1
|
| | | |-- postOfficeBoxIdentifier.FreeFormText
|
|
CHAR (9)
|
333
|
0..1
|
| | | |--regionName.FreeFormText
|
Mandatory for Japan, US, and Canada addresses. Enter state or province of billing address.
Example: “CA” for California
|
CHAR(60)
|
Table : Purchase Order Level Requested Ship Date and Address in PIP 3A4 V02.00.00
No.
|
Cardinality
|
PIP Element
|
Notes
|
Field Length
|
343
|
0..1
|
|-- requestedEvent.TransportationEvent
|
Required tag
|
N/A
|
344
|
1
|
| |-- DateStamp
|
The date a transportation event is requested to occur.
Date in Zulu time format.
Example: “20031010T080034.345Z”
Invalid value: 00000000Z. If provided, the system will default to Submit Date +1
|
Zulu Time Format
|
345
|
1
|
| |-- GlobalTransportEventCode
|
Send the values “Ship” “Dock” or “Pick-up”
Ship: The event representing when the product is requested to ship.
Dock: The event representing when the product should arrive on the recipient's dock.
Pickup: The event representing when the product is scheduled to be picked up from the shipper's dock.
If the sent values are not what is set-up by Cisco for the Customer. Cisco will override the same with the value derived
|
RosettaNet Value.
|
370
|
0..1
|
|-- shipTo.PartnerDescription
|
Required tag
|
N/A
|
371
|
1
|
| |-- BusinessDescription
|
Required tag
|
N/A
|
372
|
0..1
|
| | |-- businessName.FreeFormText
|
Enter Ship-To customer name for this product.
Example: Global Router Systems, Inc.
|
CHAR(50)
|
373
|
0..1
|
| | |-- GlobalBusinessIdentifier
|
Not Used by Cisco.
|
Char (13)
|
374
|
0..1
|
| |-- ContactInformation
|
Shipping contact. Optional information, however it helps in processing partner’s order if partner enters this data.
For Cisco to persist information - system needs contact First Name, Contact Last name and an email ID/Phone - only when thess are provided will system be able to persist shipping contact information
|
N/A
|
375
|
0..1
|
| | |-- contactName.FreeFormText
|
First and last name separated by a space.
Note: Only one name can be sent.
.
Example: “Tom Knupp”
|
CHAR(50)
|
376
|
0..1
|
| | |-- EmailAddress
|
|
CHAR(240)
|
377
|
0..1
|
| | |-- facsimileNumber.CommunicationsNumber
|
|
CHAR(30)
|
378
|
0..1
|
| | |-- telephoneNumber.CommunicationsNumber
|
|
CHAR(30)
|
379
|
1
|
| |-- GlobalPartnerClassificationCode
|
End User, Distributor, or any valid value. Cisco does not use this field.
|
|
380
|
0..1
|
| |-- PhysicalAddress
|
Required tag
|
N/A
|
381
|
0..1
|
| | |-- addressLine1.FreeFormText
|
Street address of Ship-To company. Do not use this field for order notes. If additional department or building information is required, please place them in this field. Move street address to next addressline.
Example: “170 WEST TASMAN DRIVE”
|
CHAR(240)
|
382
|
0..1
|
| | |-- addressLine2.FreeFormText
|
Street address of Ship-To company. Do not use this field for order notes. If additional department or building information is required, place them in this field. Move street address to next address line.
|
|
383
|
0..1
|
| | |-- addressLine3.FreeFormText
|
Street address of Ship-To company (if not already supplied in addressline 1 or 2.
|
|
384
|
0..1
|
| | |-- cityName.FreeFormText
|
City of street address of ship-to company.
Example: “San Jose”
|
CHAR(60)
|
385
|
0..1
|
| | |-- GlobalCountryCode
|
ISO country code of street address of ship-to company. UPPERCASE only.
Example: “US”
|
CHAR(2)
|
386
|
0..1
|
| | |-- GlobalLocationIdentifier
|
If partners provide a valid location identifier, system uses this instead of the address on the PO. However a known system limitation is that an invalid ID on this tag results in an order rejection
|
NUMBER
|
387
|
0..1
|
| | |-- NationalPostalCode
|
If partner plans on using 10 digit code for American addresses, omit hyphen “-“. Hyphen “-“character is not allowed.
|
CHAR(9)
|
388
|
0..1
|
| | |-- postOfficeBoxIdentifier.FreeFormText
|
|
CHAR (9)
|
389
|
0..1
|
| | |-- regionName.FreeFormText
|
Mandatory for Japan, US, and Canadian addresses. State or province of billing address.
Example: “CA” for California
|
CHAR(60)
|
Share with your friends: |