
AI for Importers: Standardize Orders, FX Contracts and Documents
Which order, FX and document fields need standard definitions so an AI agent can track import deadlines reliably. A practical guide for importers.
Want to apply this in your company?
Book a call with Juan →An AI agent can track import deadlines reliably only when orders, FX contracts and shipping documents use the same fields, dates and status values across every shipment. When they do not, the problem is rarely the model itself. The agent cannot tell which date governs, which document is missing, or which FX contract belongs to which invoice. Standardization is the groundwork that comes before the agent, and it decides whether deadline tracking can be trusted.
Key takeaways
- A deadline is only tracked when it exists as its own field: shipment date, expected arrival, FX settlement date and document cutoff must be separate, never buried in a notes column.
- Every import needs one unique key that links the purchase order, supplier invoice, FX contract, bill of lading and import declaration.
- Status should be a closed list of chosen values, not free text typed differently by each team member.
- Deadline rules, such as the agreed Incoterm, how days are counted and quote validity, should be written in a document, not kept only in the heads of the people who run operations.
- The agent should read, record and alert. Decisions on FX, penalties, cancellations and tax classification stay with the accountable people.
Where agents get deadlines wrong in practice
Most deadline errors start at the handoff between systems. The order sits in a spreadsheet, the invoice arrives by email, the shipping status appears in a message from the freight forwarder, and the FX contract lives with treasury or the bank. Each source uses its own conventions for dates, currencies and supplier names.
If the spreadsheet records the order date and the invoice records the shipment date, a deadline counted from the order can look overdue or comfortable when it is neither. An agent that reads both sources without an explicit rule may pick one of them silently, and that is the hardest error to notice. So the first task is not choosing a model. It is deciding which field is the source of truth for each piece of information.
Order fields that need to be standardized
The purchase order is the backbone of the process. The minimum fields usually look like this:
- A unique order identifier, linked to the supplier reference and the internal purchase order number.
- Supplier legal name, country of origin and invoicing currency, without different abbreviations for the same company.
- The agreed Incoterm and its reference location, since it defines responsibilities and the point where risk transfers.
- Separate dates: order date, production date confirmed by the supplier, and the date promised to the internal or end customer.
- Quantity, unit of measure and the NCM tax classification code, filled in by the team responsible for it. The agent can flag inconsistencies, but it should not classify goods on its own.
- Payment terms in a fixed format, for example advance payment, or a period counted from an event that is also recorded in the system.
- The internal owner and the supplier contact channel, so the agent knows whom to reach and by which means.
If one of these fields is empty, a business rule should state what happens: the agent suppresses the deadline alert, or it raises an incomplete data notice to the person managing the order. Letting the model fill the gap with an estimate is the shortest path to a wrong deadline.
FX: what the agent needs to read clearly
An FX operation has a financial side and a timing side, and the agent should track only the timing. The fields it needs to see are the operation currency, the foreign currency amount, the contracted rate and closing date, the expected settlement date, and the link to the invoice and the order.
FX deadlines rarely line up with shipping deadlines. A contract can expire before the goods arrive, and that needs to appear as an alert early enough for treasury or the bank to act. It is also worth recording who approves rate variations and above what threshold approval is required. The agent can remind the person of the rule, but it should not negotiate or decide.
One important caution: any FX information sent to AI models hosted outside Brazil must pass a review for international data transfer, especially when it includes personal data such as representatives' names or supplier contacts. The topic is covered in international data transfer with AI under LGPD.
Documents and status: the list that closes the process
Documentation is where the legal deadline and the operational deadline meet. A process can have the right status and still be missing one document that blocks customs clearance. Each document therefore needs three attributes: who is responsible for delivering it, the deadline for delivery, and where the official file is stored.
The documents most often involved in an import include the commercial invoice, the packing list, the bill of lading, the certificate of origin when applicable, any product-specific licenses or approvals, the import declaration and the proof of payment. The exact list depends on the product and the customs regime, and it should be confirmed by the foreign trade team or the customs broker.
The status list also needs to be closed. A simple set might be: waiting for supplier, in production, shipped, in transit, in customs clearance, held, released and delivered. Each transition needs a clear rule about who may change the status and what evidence is required. If a status can only change when a document is attached, the agent has a way to check consistency.
A status nobody is required to justify stops being useful for deadlines at the moment it is needed most.
Illustrative scenario
Illustrative scenario: a home goods importer tracks orders in a spreadsheet and receives supplier invoices by email. One order has the shipment date filled in on the invoice, but the spreadsheet still records the order date as the deadline reference. Without a precedence rule, the agent could raise a delay alert on the wrong day.
With the standard in place, the rule states that the shipment date on the invoice is the official source for arrival calculations, and that any conflict between sources produces a notice to the order owner instead of an automatic choice. Early in the pilot, the agent logs the notice, the person confirms the correct date, and the spreadsheet is corrected. The gain here is not the agent's intelligence. It is clarity about which data governs.
A low-risk plan to start
The sequence we follow with clients is usually short and disciplined:
- Map the current flow: identify where each piece of data comes from, who enters it, when, and how often the information changes.
- Write the field dictionary: for each field, define its name, format, official source, and examples that are accepted and rejected.
- Limit the agent's actions: it reads orders, records status, generates alerts and drafts messages. It does not change FX contracts, issue documents, or confirm deadlines with suppliers without human approval.
- Test before operating: build cases with incomplete data, conflicting dates and statuses outside the list, using shipments already closed. The method is described in how to test AI agents with mocks and a sandbox.
- Pilot one supplier group: choose a small set of real orders and agree on a success measure before starting, such as the share of alerts the team confirms as valid.
- Hand over and decide: at the end of the pilot, the company decides whether to expand, adjust the rules or stop.
In our way of working, this path follows four verbs: map, limit, pilot and hand over. The process makes no promise of results. It only requires that every step has a record, a criterion and an owner.
What stays with the team
Some decisions should not be delegated, even with a well-configured agent. These include FX negotiation, accepting penalties or extra costs, changing the Incoterm mid-process, tax classification, and deciding whether to tell the end customer about a delay. The agent can prepare the material for each of these decisions, with history and evidence, but the sign-off is human.
If the agent also talks to suppliers over WhatsApp, pay attention to the rules for sending messages outside the customer service window. The mechanics are explained in the 24-hour window on WhatsApp API. For companies already using purchasing agents, the logic of comparing quotes and requesting approval follows similar principles, covered in an AI agent for procurement.
Frequently asked questions
Do I need to replace our ERP to use an AI agent for import tracking? Not necessarily. Many operations start with well-structured spreadsheets, emails with standardized fields, and a status record the agent can access. What matters is having one official source per field and a closed status list, whatever tool you use.
Can the agent decide when to close an FX contract or when to pay a supplier? It should not. The agent's role is to read dates, flag upcoming expirations, record discrepancies and alert the responsible person with the history they need. The financial decision and the payment remain with the finance team, with approval on record.
Can we start a pilot before standardizing every field? Yes, you can start with a subset of orders and fields, as long as the scope is written down and cases outside it are handled manually. Trying to standardize everything before any test usually delays the project without visibly reducing errors.
Do we need superintelligence to track import deadlines? No. This kind of tracking depends on well-organized data, clear rules and a model that can read documents and text within defined limits. The superintelligence debate does not change what your company needs to do next: organize the fields, record decisions, and measure whether the alerts help the team.