Importer Security Filing (ISF 10+2)
Strix web service integration documentation
Overview
Importer Security Filing data elements for ocean shipments.
isf is the root element of the document.
isfMessage structure
Available operations
SOAP 1.1 (RPC/literal)uploadIsfParameters: username, password, isfXml
Returns: XML response (string)
amendIsfParameters: username, password, isfXml
Returns: XML response (string)
deleteIsfParameters: username, password, isfReferenceNumber
Returns: XML response (string)
queryIsfStatusParameters: username, password, isfReferenceNumber, customerRefNumber
Returns: XML response (string)
Example request
Example responses
<uploaded><reference-no>12345</reference-no></uploaded>ISF XSD Fields
transmittransmit is an optional tag. If included, the system will transmit this ISF to U.S. Customs once it has been uploaded to this system.
assign-toThis is the username of the user who this entry should be assigned to. This tag is optional. If this tag is omitted, the entry will be assigned to the user whose username and password is submitted as the security credentials for the uploadIsf/amendIsf operations on this web service
reference-numberThis is a number that you can include to uniquely identify this ISF. This tag is optional. If not included, the system will generate one for you.
isf-typeisf-type must be either 5 or 10. This is the old ISF type tag, which has been deprecated but remains for backwards compatibility. It is recommended to use the <isf-submission-type> tag instead. This tag is optional if <isf-submission-type> is used.
isf-submission-typeIt is recommended to use this tag to input the ISF type over the older <isf-type> tag, which is now deprecated. This tag is optional if <isf-type> is used. isf-submission-type must be either 1-6. 1 - Importer Security Filing 10 (ISF-10) submission 2 - Importer Security Filing 5 (ISF-5) submission 3 - ISF-5 submission type is being changed to an ISF-10 4 - ISF-10 submission type is being changed to an ISF-5 5 - Late ISF-10 submitted without a bond 6 - Late ISF-5 submitted without a bond
shipment-typeshipment-type must be included if isf-type is 10. 01 = Standard or regular filings 02 = To Order Shipments 03 = Household Goods / Personal Effects (HHG / PE) 04 = Military, Government 05 = Diplomatic Shipment 06 = Carnet 07 = US Return Goods 08 = FTZ Shipments 09 = International Mail Shipments 10 = Outer Continental Shelf Shipments 11 = Informal
transaction-typetransaction-type must be: CT - Compliant Transaction FR - Flexible Range FT - Flexible Timing FX - Flexible Range and Timing
customer-reference-numberThis tag contains the customer reference number. It is optional.
importerThe importer tag has a choice of 2 sub-elements: tax-id or passport. tax-id must conform to the data:taxIdType. passport is itself a complex type that must contain passport-number, date-of-birth, and issuing-country. If ISF Importer Number Qualifier = 'AEF' (Passport Number) or '34' (SSN), the <date-of-birth> and <name> tags should also be populated.
freight-forwarder-idUse the Identifier found above Profile Name on the Freight Forwarder Information page.
mode-of-transportmode-of-transport must contain a single sub-element, either containerized or non-containerized
bond-informationThis contains all of the bond information pertaining to this ISF
master-scacThis should be the 4 character SCAC code of issuer of the master bill. This tag is optional
cbp-entry-numberThis tag contains the cbp entry number. It is optional
port-of-unladingThis tag should only be included if the isf-type is 5
place-of-deliveryThis tag should only be included if the isf-type is 5
informal-shipment-informationIf the Shipment Type is 11 (Informal), then the following data fields are required: 1. Shipment Sub-Type 2. Estimated Value 3. Estimated Quantity 4. Unit of Measure 5. Estimated Weight 6. Weight Qualifier
product-informationproduct-information should be included if the ISF type is 5