Embedded Files
The paperless integration introduces a dedicated container within the existing ShipmentRequest.
Once the document is successfully uploaded through the UploadPaperlessDocumentRequest, it can be attached directly within the ShipmentRequest call, inside a new container within the request (as it happens for attaching to request the Proforma data).
In details:
Within the request, you can attach one or more documents at the same time.
For international shipments the ProformaInvoice container must be filled in.
Example:
<ProformaInvoice>
<ProformaDetail>
<Amount>1</Amount>
<Currency>JPY</Currency>
<Value>1000</Value>
<Unit>PCS</Unit>
<Description>Brocche</Description>
</ProformaDetail>
</ProformaInvoice>
Amount = indicates the quantity of the item described on this line. In this case, you are declaring there is 1 unit of the item. This field is critically linked to the <Unit> field
Currency = specifies the currency for the <Value> field. In this case, JPY is the ISO code for the Japanese Yen. Without this information, a value of "1000" is meaningless
Value = declares the total monetary value of the line item (i.e., the value for the quantity specified in <Amount>). This value is the basis upon which customs calculates any applicable duties and import taxes (like VAT). An accurate value is crucial to avoid penalties
Unit = specifies the unit of measure for the <Amount> field. The most common field is PCS, which stands for "pieces".
Other recognised values are: BOX (Box), CM (Centimeter), DOZ (Dozen), EA (Each/Number), KG (Kilogram), KGS (Kilograms), L (Liter), M (Meter), PCS (Pieces), LB (Pound), PF (Proof Liter), ROL (Roll), SET (Set), SME (Square Meter), SYD (Square Yard), YD (Yard), CM2 (Square centimeter), M3 (Cubic meter), 2M2 (Square feet), 3M2 (Square inch), 2L (Gallon), X (No unit), 2KG (Ounce)
Description = this is the clear, plain-language description of the goods. Vague descriptions like "Gift" or "Sample" are often rejected and cause delays
Request Sample
Request Sample
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://www.onlinembe.it/ws/">
<soapenv:Header/>
<soapenv:Body>
<ws:ShipmentRequest>
<RequestContainer>
<Credentials>
<Username></Username>
<Passphrase></Passphrase>
</Credentials>
<System>IT</System>
<InternalReferenceID>test</InternalReferenceID>
<Recipient>
<Name>Receiver</Name>
<CompanyName>ReceiverLTD</CompanyName>
<Address>857 Grant St, Denver</Address>
<ZipCode>80203</ZipCode>
<City>Denver</City>
<State>CO</State>
<Country>US</Country>
<Phone>1234567891</Phone>
<Email>sadsaads@gfdsdsffds.com</Email>
</Recipient>
<Shipment>
<ShipperType>COURIERLDV</ShipperType>
<Description>TEST</Description>
<COD>false</COD>
<Insurance>false</Insurance>
<Service>SEE</Service>
<PackageType>GENERIC</PackageType>
<Referring>TestDIP2</Referring>
<Items>
<Item>
<Weight>2</Weight>
<Dimensions>
<Lenght>1</Lenght>
<Height>1</Height>
<Width>1</Width>
</Dimensions>
</Item>
</Items>
<PaperlessDocuments>
<PaperlessDocumentId>165</PaperlessDocumentId>
</PaperlessDocuments>
<Products>
<Product>
<SKUCode>SKU123456</SKUCode>
<Description>Test Item</Description>
<Quantity>1</Quantity>
</Product>
<Product>
<SKUCode>SKU7899</SKUCode>
<Description>Test Item2</Description>
<Quantity>1</Quantity>
</Product>
</Products>
<ProformaInvoice>
<ProformaDetail>
<Amount>1</Amount>
<Currency>JPY</Currency>
<Value>1000</Value>
<Unit>PCS</Unit>
<Description>Brocche</Description>
</ProformaDetail>
</ProformaInvoice>
<InternalNotes>TEST</InternalNotes>
<Notes>TEST</Notes>
<LabelFormat>NEW</LabelFormat>
</Shipment>
</RequestContainer>
</ws:ShipmentRequest>
</soapenv:Body>
</soapenv:Envelope>
Response Sample (OK)
Response Sample (OK)
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:ShipmentRequestResponse xmlns:ns3="http://www.onlinembe.it/ws/">
<RequestContainer>
<InternalReferenceID>test</InternalReferenceID>
<Status>OK</Status>
<SystemReferenceID>ES0025-0L-0000000715</SystemReferenceID>
<MasterTrackingMBE>ES0025-0L-0000000715</MasterTrackingMBE>
<TrackingsMBE>
<TrackingMBE>ES0025-0L-0000000715-01</TrackingMBE>
</TrackingsMBE>
<Labels>
<Label>
<Stream>EgMCBSL0lEIFs8MjYxNmU3YjQzOWVjZmQwNGQyZGE1YzZkYjNkZWU2MjQ+PDBhNGQ1YWViZDJiMDQ2YzE1YzRlNjQ4MGVkNWU4OGMzPl0vUm9vdCAyMCAwIFIvU2l6ZSAyMj4+CnN0YXJ0eHJlZgoyODExMgolJUVPRgo=</Stream>
<Type>PDF</Type>
</Label>
</Labels>
<CourierMasterTrk>794605991364</CourierMasterTrk>
</RequestContainer>
</ns3:ShipmentRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Response Sample (KO)
Response Sample (KO)
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header/>
<SOAP-ENV:Body>
<ns3:ShipmentRequestResponse xmlns:ns3="http://www.onlinembe.it/ws/">
<RequestContainer>
<InternalReferenceID>test</InternalReferenceID>
<Status>ERROR</Status>
<Errors>
<Error>
<Id>6</Id>
<ErrorCode>SR_006</ErrorCode>
<Description>Paperless documents not found</Description>
</Error>
</Errors>
</RequestContainer>
</ns3:ShipmentRequestResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Page updated
Report abuse