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>