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
NameTypeRequiredDescription
AuthenticationTokenstring(50)YesAlliance cloud security token.
Body
NameTypeRequiredDescription
WarehouseCodestring(8)Yes/No Warehouse code, required for PostType = LOCAL, use DGG. Not required for PostType = FINAL.
ConsigneeCodestring(32)YesPO Customer Code.
PoNumberstring(50)NoPo Number.
OriginPortCodestring(3)NoIATA origin airport code. For local orders for Miami, use MIA. For other POs use correspondent IATA code, ex. UIO, BOG, MDE, SJO.
DestinationPortCodestring(3)YesIATA destination airport code. For local orders for Miami, use MIA. For other POs use correspondent IATA destination code, ex. MIA, AMS.
EstimatedDateDate(yyyy-MM-dd)NoSupplier delivery date to Logiztik Alliance Group warehouse.
Commentsstring(64)NoComment.
PostTypestring(5)YesFor local orders send LOCAL, for POs from origin send FINAL.
Accionstring(6)NoTo insert or update the information send INSERT, to delete the information send DELETE.
ShipToCodestring(32)NoShip-to code.
CarrierCodestring(32)NoTrucking company code.
DispatchDateDate(yyyy-MM-dd)NoShipping date from Logiztik Alliance Group warehouse to the final customer.
FarmCodestring(32)YesSupplier code.
Barcodestring(11)NoBarcode 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.
BoxSizestring(3)NoBox type (ex. FB, HB, QB…).
ProductCodestring(32)NoProduct category code (ex. ROS for roses).
ProductDescriptionstring(127)NoProduct variety, can be used whatever text of max. 127 digits to explain to the supplier what exact product is requested.
PackingintNoNumber of units in the box.
UnitPricedecimal(9,3)NoPrice per unit, obligatory for Canada.
Lengthdecimal(9,3)YesLength of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0.
Widthdecimal(9,3)YesWidth of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0.
Hightdecimal(9,3)YesHeight of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0.
GrossWeightdecimal(9,3)YesWeight of the piece. Obligatory for Local Orders to Miami (PostType LOCAL), for PostType FINAL can be 0.
UnitOfMeasurementstring(16)YesUnit of measure for the dimensions, CM or INCH.
Commentsstring(128)NoComment.
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

NameTypeDescription
IsSuccessstring(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

NameTypeDescription
IsSuccessstring(5)Output Error (False).
pOnumberstring(400) 
clientstring(400) 
exporterstring(400) 
messagestring(250)In case of an error, we return the error message in this field.
elementNumberstring 
generalstring 
messageTypestring(11) 
accionstring(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>