Migration playbook
From email threads to a controlled import workflow
Move email-driven import work into a controlled workflow by linking each actionable message to one shipment, one accountable owner, a required response, a deadline with its time zone, the current evidence and a closure decision. Keep email for communication; give the team a shared record of what is still waiting. Start with a bounded pilot, reconcile open work and files, then change the operating source only when the receiving team can continue without reconstructing the inbox.
By Ayhan Karaca, Co-Founder · Updated: September 9, 2026
What turns an email into an accountable action?
A forwarded thread transfers information but does not necessarily transfer responsibility. For every actionable reply, record the shipment reference, requested decision, owner, backup, response deadline, source message and evidence version. The owner is the person who checks whether the request was actually satisfied; everyone copied on the email is not a shared substitute.
Before sending another reminder, classify the state: not requested, waiting for response, received but unreviewed, blocked by a discrepancy, or accepted and closed. A delivery receipt proves transmission only. A reply such as “sent” still leaves work open if the requested file cannot be retrieved or its shipment identity is unclear.
- Actionable message: a request, commitment, changed date, revised file or unresolved decision affecting an identified shipment.
- Informational message: retain relevant context without creating a duplicate task or asking the partner to repeat a completed response.
- Ambiguous message: keep it unresolved, name who will clarify it and record when that clarification is needed.
Use a handoff record that survives an absent owner
Copy this template into your approved operating record. It is a proposed team control, not a claim that every field is a dedicated Tyllus form field. Keep sensitive correspondence in the access-controlled source and use a retrievable reference instead of pasting an entire mailbox.
| Field | What to record | Acceptance check |
|---|---|---|
| Shipment and scope | Shipment reference; PO, bill or container as supporting references; destination jurisdiction | The receiving owner can distinguish split shipments and reused references. |
| Request and owner | One required outcome; accountable person; backup; intended partner role | One person accepts responsibility and can cover an absence. |
| Deadline and escalation | Date, time, time zone; business cutoff; next escalation owner | A missed response leads to an explicit decision before the operational cutoff. |
| Evidence and version | Source message reference; document type; issuer; version/date; accepted or superseded state | The recipient opens the current file with their own access. |
| Review and closure | What was checked; discrepancy; reviewer; acknowledgement; next action | Close only when the required evidence and decision exist. |
Handle partial replies, revisions and silence differently
Use one request owner to prevent two colleagues from chasing the same partner independently. When a response changes the request, update the open action and preserve its previous context. Do not turn a new attachment into a second competing shipment record.
| Incoming event | Owner action | Keep open until |
|---|---|---|
| No reply by the agreed checkpoint | Check delivery and recipient, then escalate with shipment, request and cutoff context. | The partner responds or an authorized owner records a fallback decision. |
| Partial response | List only the missing fields or files; retain what was already received. | The remaining requirement is supplied and reviewed. |
| Revised invoice or packing list | Keep the earlier version identifiable, link the revision and reopen affected checks. | The document reviewer resolves conflicting quantities, values or identities. |
| Changed ETA or readiness date | Record the source and distinguish the estimate from a confirmed milestone. | The responsible logistics owner checks downstream appointments and handoffs. |
| Owner absent or access denied | Assign the backup and test recipient access before treating the handoff as complete. | The receiving owner acknowledges the action and can retrieve its evidence. |
Preserve file continuity when a thread changes
Use a document register that records the shipment, document type, issuer, received date, revision, review state, source reference and receiving owner. Preserve the distinction between received, reviewed, accepted and superseded. A file named final.pdf is not evidence of acceptance, and a newer upload does not by itself explain which prior decision changed.
Test the handoff with the actual receiving role. Can that person retrieve the current commercial invoice and packing list, see the unresolved discrepancy and locate the source? If a sharing link expires or access is denied, keep the task open while the owner restores the approved delivery path. Retention and access rules belong to the organization and its advisers; this guide sets no universal retention period.
- Record the reason a revision replaced the previous file, rather than silently overwriting the accepted version.
- Recheck dependent cost, quantity and customs-preparation reviews when their evidence changes.
- Keep an archive reference that a backup owner can use; do not store passwords, private links or raw customer files in public templates.
Research and official sources
Worked example: a revised invoice before broker handoff
Illustrative scenario, not customer data: a supplier sends a revised commercial invoice after a packing list was already reviewed. The email owner matches it to the shipment and records that the invoice changed. The document owner compares identity, quantity and value with the packing list; a discrepancy remains blocked until the supplier or responsible reviewer resolves it.
The logistics owner checks whether the broker already received the earlier file and sends the accepted revision through the approved channel. The broker-facing handoff remains open until the recipient acknowledges the current package and any unresolved questions. Finance rechecks affected cost evidence. No step labels the shipment customs-cleared merely because an email was answered.
- Opportunity to protect: the ability to correct the package before the next handoff cutoff.
- Time to measure: active minutes spent locating the source, checking the revision and clarifying ownership, separately from elapsed partner waiting time.
- Closure evidence: accepted version, reviewer decision, recipient acknowledgement and a named owner for any remaining exception.
Start with a source inventory, not the upload button
List every workbook, tab, shared drive, mailbox rule, report, and person-maintained side list that changes a shipment decision. For each source, record its owner, date range, update cadence, identifier, fields, formulas, access group, downstream consumers, and known exceptions. The purpose is to discover the operating contract hidden inside the tools.
| Control | Evidence to retain | Release condition |
|---|---|---|
| Canonical identity | Legacy row, shipment reference, PO, container or bill references | Duplicate and collision rules approved |
| Field mapping | Source field, target field, transform, owner | Required fields and allowed values validated |
| Document linkage | Original path or message, file, source, shipment | Unmatched and duplicate files remain visible |
| Operational state | Status, milestone, date source, next action | Stale or inferred state is not silently accepted |
| Financial reconciliation | Currency, cost category, invoice, source total | Counts and currency totals reconcile within approved tolerance |
| Cutover and archive | Sign-off, export, access policy, rollback reference | New master named; legacy source made read-only |
Use a nine-step migration with explicit stop conditions
A reliable migration is a sequence of decisions, not a bulk-copy event. Pause when identifiers collide, mandatory values are absent, currency meaning is unclear, or a legacy formula cannot be explained. Record the disposition instead of forcing the row through.
Read the migration sequence
Inventory sources. Define canonical shipment identity. Map fields and values. Clean duplicates and unresolved records. Preview the Tyllus import. Confirm accepted rows. Link files and open exceptions. Run a time-boxed parallel period and reconcile. Cut over, archive source records, and monitor the first reporting cycle.
What can Tyllus import—and what must remain a reviewed exception?
Tyllus provides a supported shipment spreadsheet flow with upload authorization, preview, and confirmation. Use the preview as a control point: validate mapped fields, required values, duplicates, permissions, and the intended workspace before confirmation. After import, connect documents, owners, milestones, costs, and outstanding decisions to the shipment record.
Arbitrary Gmail history is not imported. Preserve material correspondence under an approved policy and bring only the relevant operational outcome or evidence into the shipment context. A sent message is not automatically an accepted fact; an attachment is not automatically the current or legally sufficient version.
- Import supported structured shipment data only after a preview review.
- Quarantine ambiguous references, currencies, dates, and status values.
- Keep the original source and transformation decision available for reconciliation.
- Assign each unresolved row or file to a named owner and disposition.
- Protect workspace access and do not migrate secrets or unnecessary personal data.
Run a bounded pilot with a recovery decision
Choose one repeatable handoff and a small declared set of active shipments, with a primary owner, backup and end-of-pilot review date. Define the source of truth for each stage so a temporary parallel review does not create two active masters. Set acceptance thresholds before the pilot using the team’s own risk and workload; no shipment count or duration is universally safe.
At each review, reconcile open requests, accepted files, current owners and cutoff-sensitive exceptions against the preserved source. Stop expansion if an identity collision, missing accepted file, inaccessible handoff or unexplained count difference remains. Keep the last reconciled operating view available, assign the discrepancy and resume only after a reviewer records the correction. Do not delete the original source to make the counts match.
| Gate | Evidence | If the gate fails |
|---|---|---|
| Identity | Every pilot shipment maps to its source; duplicates have a disposition. | Pause affected rows and resolve the collision. |
| Open work | Every open request has an owner, deadline and next step. | Keep the previous reviewed queue available and assign the missing owner. |
| Files | Current accepted files and superseded references are retrievable by the receiving role. | Restore approved access and repeat the handoff check. |
| Continuity | Backup owner can continue a selected live exception using the shared record. | Record the missing context and repeat the review before expanding. |
| Cutover | Named approver accepts reconciled counts, open exceptions and archive access. | Keep the pilot bounded; revise the plan instead of declaring completion. |
Measure handling time and missed handoff checkpoints
Define the eligible request set and observation period before collecting a baseline. Compare equivalent handoffs, lanes, shipment stages and staffing conditions. Record source gaps and the sample size alongside every result. A lower email count can hide unrecorded work; it is not sufficient evidence of improvement.
Separate labor from exposure. Active handling minutes describe work performed; elapsed response time describes waiting. An opportunity lost at a cutoff is a reviewed event with a source, owner and stated consequence, not an assumed fee. Do not add hypothetical delay exposure to actual labor cost or claim the workflow caused a change without considering shipment mix and external delays.
| Measure | Definition | Comparison boundary |
|---|---|---|
| Unowned open requests | Open requests without a named accountable owner / all eligible open requests at the same review point. | Keep the denominator and review time consistent. |
| Active handling time | Sum observed minutes locating, clarifying, reconciling and chasing / completed eligible handoffs. | Separate observed time from estimates; exclude elapsed waiting. |
| File retrieval success | Sampled handoffs where the receiver opens the current accepted file / all sampled handoffs. | Declare the access role and sampling method; report failed retrievals. |
| Missed response checkpoints | Requests without an adequate response at the agreed checkpoint / requests due in the period. | Distinguish partner silence, partial response and unresolved internal review. |
| Reopened handoffs | Closed handoffs reopened for missing or conflicting evidence / closed eligible handoffs. | Record reasons and do not count an accepted revision as a new shipment. |
How do you prove the cutover did not lose operational truth?
Reconcile at three levels. At record level, compare shipment identities, status, key dates, and linked evidence. At portfolio level, compare shipment counts by state, supplier and lane counts, invoice counts, and currency-separated costs. At workflow level, sample active exceptions and confirm the next owner can act without returning to the legacy tracker.
Keep the parallel period short and declared. Two masters create more ambiguity, not more safety. When acceptance criteria pass, name Tyllus as the operating record, make legacy sources read-only, preserve an approved archive, and document where specialist calculations or external systems still govern.
What should the first 30 days measure?
Track imported, rejected, corrected, duplicate, and unresolved rows; matched and unmatched documents; active shipments with owners; report reconciliation differences; and the number of decisions that still require a legacy source. Review the definitions weekly and fix the workflow that creates the gap—not only the data row.
CBP describes targeted ACE reports as tools for internal audits and identifying systemic errors. ACE remains the government system and Tyllus does not replace it. The relevant practice is to make operational reports lead back to the source record and use recurring differences to improve the process.
Research and official sources
Practical questions before cutover
Do partners have to stop using email? No. The proposed control is that meaningful replies and decisions stay connected to the shipment. Agree the response channel for the specific request; do not assume all partner actions have the same access requirements.
Does Tyllus import an entire Gmail mailbox? No. Its supported spreadsheet flow uses preview and confirmation; relevant documents and operating context need their own reviewed handling. Automatic shipment email sequences depend on the shipment’s configured flow. Turning a workflow on is a deliberate operating choice, not a consequence of reading this guide.
When should the legacy tracker become read-only? After the named approver accepts the reconciled pilot and confirms who owns unresolved work and archive access. Specialist records and government systems keep their own authority.
What should a small team do first? Select one recurring supplier-document or broker-handoff request. Name the owner and backup, capture its deadline and evidence, then check whether another colleague can continue it without searching the original owner’s inbox.
Design the cutover around one representative shipment.
Show Tyllus the source columns, identity rules, exceptions, documents, and reconciliations that matter. The result should be a scoped migration decision, not a blind upload promise.

