Skip to content
Octo × Cargo and customs PT Request an assessment

Octo for cargo and customs

Cargo leaves a trail in customs. Octo helps keep your system on the same trail.

Customs offices oversee the entry, stay, movement and exit of cargo units and goods. The Portal Único Siscomex publishes a REST API, which includes import cargo control for the waterway mode, and Siscomex Carga allows the loading and unloading report to be filed by web service. Octo can prepare the integration of your company's system, for companies authorized by the Federal Revenue Service.

The company's system, the XSD schemas and Federal Revenue authorization go into Octo, which returns validated XML or JSON messages and the reconciled inventory. INPUT COMPANY SYSTEM XSD SCHEMAS RFB AUTHORIZATION MESSAGES XML · JSON INVENTORY CHECKED REST → XML/JSON validated against the XSD OCTO × PORTS CARGO AND CUSTOMS GP-06
Portal ÚnicoRESTXML and JSON, with XSD
Duimp queries1,000/hper user, accessed October 28, 2026
AccessRFBonly for those authorized in foreign trade
Sources5listed at the end of the page
01

What Octo does with cargo and customs.

Four possible deliverables. All of them run with your company's access and go through the team's review.

Integration with the Portal Único

Can write the client for the Portal Único REST API, in XML and JSON, validating each message against the published XSD before submission.

Deliverable: integration client for review

Queries within the limit

Can queue the automated Duimp queries so they do not exceed the limit of 1,000 queries per hour per user (accessed October 28, 2026).

Deliverable: query routine with rate control

Reconciled inventory

Can compare the receipt, delivery and devanning events and the CCT Importação inventory with internal records and list the differences.

Deliverable: list of differences for the team

Loading and unloading report

Can prepare the filing of the loading and unloading report in Siscomex Carga by web service, from the data your company's system already has.

Deliverable: submission routine for review and approval
02

Eight arms, one cargo trail.

The same Octo cycle, applied to this topic. Each arm has a narrow role; the people who approve and sign are on your team.

  1. Discovery

    Identifies the authorization

    Which authorization your company holds with the Federal Revenue Service and which services it uses.

  2. Data

    Maps field to field

    Each field in the company's system linked to the field in the official message, checked against the XSD.

  3. Security

    Uses the company's access

    Certificate and credentials stay with the company. Octo has no access of its own.

  4. Architecture

    Chooses the service

    Portal Único, CCT or Siscomex Carga, depending on the task.

  5. Development

    Writes the integration

    Message assembly, XSD validation, rate control and a record of each response.

  6. Review

    Tests with the queries

    Starts with the queries, which change nothing, and compares with what the team sees in the system.

  7. Release

    Publishes with your OK

    Submissions only go into use after your team's approval.

  8. Documentation

    Records the version

    Which version of the specification and the manual was used.

Octo does not replace the party authorized by the Federal Revenue Service. The integration runs with your company's access, and your company answers for the information.

03

Each task, its path.

The criteria Octo uses to pick the path. The regulation and the official system remain the reference.

TaskPathNote
Knowing who oversees cargoCustoms officesLaw 12.815/2013, art. 24, II
Integrating with the Portal ÚnicoREST API, XML and JSON, with XSDPortal Único documentation
Import cargo in the waterway modeCCT Importação: receipt, delivery, devanning and inventoryCCT API specification
Automated Duimp queriesIntegre seu sistema (Integrate your system)1,000 queries per hour, per user (accessed October 28, 2026)
Loading and unloading reportSiscomex Carga, web serviceSiscomex Carga manual
04

From request to routine.

Three steps. Each one only makes sense once the previous one has shown results on your team.

A proposal, not a promise

1 Today

Queries

Octo prepares the queries the team does by hand, within the limit.

  • Queries with rate control
  • Record of each response
Benefit: the team keeps track without copying by hand
2 Next

Inventory reconciliation

CCT events are now compared with internal records.

  • List of differences
  • Reviewed field map
Benefit: the gap shows up before the inspection
3 Later

Submissions with review

Where it makes sense, messages are now assembled by the system and approved by the team.

  • Message validated against the XSD
  • Record of who approved each submission
Benefit: the data comes from the system, not from typing
05

Confirmed by source.

Each point below has a source published by the agency responsible for the standard or the system, or by the IMO. The sources are in the next section.

6

points with a published source, each with its reference alongside.

ConfirmedCustoms oversight
Customs offices are responsible for inspecting the entry, stay, movement and exit of people, vehicles, cargo units and goods.Source: Planalto, Law 12.815/2013, art. 24, II
ConfirmedPortal Único API
Portal Único Siscomex integration is based on the REST architecture, with XML and JSON formats and XSD schemas.Source: Portal Único Siscomex documentation
ConfirmedCCT Importação
The specification for Import Cargo Control in the waterway mode includes receipt, delivery, devanning and inventory.Source: Portal Único Siscomex, CCT Importação specification
ConfirmedQuery limit
Automated Duimp queries are limited to 1,000 queries per hour, per user (accessed October 28, 2026).Source: Siscomex, Integre seu sistema
ConfirmedWho can integrate
Integration is for companies and representatives duly authorized to operate in foreign trade by the Federal Revenue Service.Source: Siscomex, Integre seu sistema
ConfirmedSiscomex Carga
The Siscomex Carga manual describes filing the loading and unloading report via web service.Source: Federal Revenue Service, Siscomex Carga manual
06

What Octo does and what stays with you.

Octo prepares everything, but does not sign. The document of record stays with whoever is accountable for it.

Octo prepares

Gathers, calculates, organizes and produces the documents: spreadsheets, reports, dashboards and drafts.

Deliverable: material ready for review

Your team reviews

The licensed professional reviews what Octo delivered before signing. If something doesn't add up, it goes back to Octo with the correction.

Step: review by whoever signs

Who signs

Octo does not sign. Designs, technical reports, ART/RRT, accountability reports and any official document are still signed by the licensed professional at the company or agency: here, the professional of record and the port authority.

Signature: professional of record and port authority
07

Sources.

Federal legislation published on Planalto, Portal Único Siscomex documentation and Federal Revenue Service manuals. Accessed October 28, 2026.

The cargo trail without typing twice.

The assessment starts with what your team reports to customs today, without changing anything. You get a proposal for what can be integrated and decide with it in hand.