Create Purchase Orders
DESCRIPTION
Web Service for sending purchase order information.
Request
Method: POST
Content-Type: application/xml
URL:
Test Environment: | https://training.logiztikalliance.com:5005/logCloudWSSprint/api/Pos/InsertarPosXmlClientesAllianceNuevaVersion/{TOKEN} |
Production Environment: | https://cloud.logiztikalliance.com:5005/logCloudWS/api/Pos/InsertarPosXmlClientesAllianceNuevaVersion/{TOKEN} |
INPUT PARAMETERS
Name | Type | Required | Description |
AuthenticationToken | string(50) | Yes | Alliance cloud security token. |
Body
Name | Type | Required | Description |
WarehouseCode | string(8) | Yes/No | Warehouse code, required for PostType = LOCAL, use DGG. Not required for PostType = FINAL. |
ConsigneeCode | string(32) | Yes | PO Customer Code. |
PoNumber | string(50) | No | Po Number. |
OriginPortCode | string(3) | No | IATA origin airport code. For local orders for Miami, use MIA. For other POs use correspondent IATA code, ex. UIO, BOG, MDE, SJO. |
DestinationPortCode | string(3) | Yes | IATA destination airport code. For local orders for Miami, use MIA. For other POs use correspondent IATA destination code, ex. MIA, AMS. |
EstimatedDate | Date(yyyy-MM-dd) | No | Supplier delivery date to Logiztik Alliance Group warehouse. |
Comments | string(64) | No | Comment. |
PostType | string(5) | Yes | For local orders send LOCAL, for POs from origin send FINAL. |
Accion | string(6) | No | To insert or update the information send INSERT, to delete the information send DELETE. |
ShipToCode | string(32) | No | Ship-to code. |
CarrierCode | string(32) | No | Trucking company code. |
DispatchDate | Date(yyyy-MM-dd) | No | Shipping date from Logiztik Alliance Group warehouse to the final customer. |
FarmCode | string(32) | Yes | Supplier code. |
Barcode | string(11) | No | Barcode number, has to be a unique number per box, maximum 11 digits long. Logiztik Alliance Group provides a 2-letter prefix that should be used together with an alphanumeric sequential. |
BoxSize | string(3) | No | Box type (ex. FB, HB, QB…). |
ProductCode | string(32) | No | Product category code (ex. ROS for roses). |
ProductDescription | string(127) | No | Product variety, can be used whatever text of max. 127 digits to explain to the supplier what exact product is requested. |
Packing | int | No | Number of units in the box. |
UnitPrice | decimal(9,3) | No | Price per unit, obligatory for Canada. |
Length | decimal(9,3) | Yes | Length of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0. |
Width | decimal(9,3) | Yes | Width of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0. |
Hight | decimal(9,3) | Yes | Height of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0. |
GrossWeight | decimal(9,3) | Yes | Weight of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0. |
UnitOfMeasurement | string(16) | Yes | Unit of measure for the dimensions, CM or INCH. |
Comments | string(128) | No | Comment. |
EXAMPLE
<XMLPosAlliance>
<Po>
<Header>
<WarehouseCode>DGG</WarehouseCode>
<ConsigneeCode>999</ConsigneeCode>
<PoNumber>53-0019763X2</PoNumber>
<OriginPortCode>UIO</OriginPortCode>
<DestinationPortCode>MIA</DestinationPortCode>
<EstimatedDate>2020-12-10</EstimatedDate>
<Comments>THIS IS A TEST</Comments>
<PostType>FINAL</PostType>
<Accion>INSERT</Accion>
</Header>
<Details>
<Detail><ShipToCode></ShipToCode>
<CarrierCode>PIK</CarrierCode>
<DispatchDate>2020-09-21</DispatchDate>
<FarmCode>EXP</FarmCode>
<Barcode>OP009257008</Barcode>
<BoxSize>QB</BoxSize>
<ProductCode>WGYMIE5</ProductCode>
<ProductDescription>FOB-GYP.MILLION STAR 5</ProductDescription>
<Packing>1</Packing>
<UnitPrice>22</UnitPrice>
<Length>10.0</Length>
<Width>4.0</Width>
<Hight>3.0</Hight>
<GrossWeight>0</GrossWeight>
<UnitOfMeasurement>INCH</UnitOfMeasurement>
<Comments></Comments>
</Detail>
</Details>
</Po>
</XMLPosAlliance>
Response
Output Success
BODY
Name | Type | Description |
IsSuccess | string(5) | Output Success (True). |
EXAMPLE
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>true</IsSuccess>
</PoStatus>
Output Error
BODY
Name | Type | Description |
IsSuccess | string(5) | Output Error (False). |
pOnumber | string(400) | |
client | string(400) | |
exporter | string(400) | |
message | string(250) | In case of an error, we return the error message in this field. |
elementNumber | string | |
general | string | |
messageType | string(11) | |
accion | string(6) |
EXAMPLE
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The consignee code 3Ldc0NYAIzBU***** does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
ERRORS MESSAGES
The consignee code does not exist
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>POXML-100X</POnumber>
<Message>The consignee code CLI0412990 does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
ORIGEN PORT DOES NOT EXIST
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>Origin port UIO00 does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
DESTINATION PORT DOES NOT EXIST
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>Destination port MIA-222 does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
There is no carrier PIK
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>There is no carrier PIK___</Message>
</PoErrorDetails>
</Message>
</PoStatus>
The exporter does not exist
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The exporter does not exist</Message>
</PoErrorDetails>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The exporter EXP00000 does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The exporter does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>
INPUT STRING WAS NOT IN A CORRECT FORMAT
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<Message>Input string was not in a correct format.</Message>
</PoErrorDetails>
</Message>
</PoStatus>
The unit of measure for po must be INCH or CM
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The unit of measure for po must be INCH or CM</Message>
</PoErrorDetails>
</Message>
</PoStatus>
Dimensions are not complete (Length, Height, Width, Gross Weight, Unit Of Measurement)
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>Dimensions are not complete (Length, Height, Width, Gross Weight, Unit Of Measurement)</Message>
</PoErrorDetails>
</Message>
</PoStatus>
Object reference not set to an instance of an object
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<Message>Object reference not set to an instance of an object.</Message>
</PoErrorDetails>
</Message>
</PoStatus>
Data type error
Could not get response.
THE WAREHOUSECODE DOES NOT EXIST
<PoStatus xmlns:xsi=”http://www.w3.org/2001/XMLSchema-instance” xmlns:xsd=”http://www.w3.org/2001/XMLSchema”>
<IsSuccess>false</IsSuccess>
<Message>
<PoErrorDetails>
<POnumber>53-0019763X2</POnumber>
<Message>The exporter does not exist</Message>
</PoErrorDetails>
</Message>
</PoStatus>