PublicSimpleCustomsDeclaration

The Id of the JSON schema.

Type: string

Example:

"https://api.thebigalice.com/schema/customs/simple_customs_declaration/v1.2/schema.json"

Status information.

Default: null

The current status of the declaration: inserted, registered, delivered, ecc

Any of

CustomsDeclarationStatus
Option 2

CustomsDeclarationStatus

Type: enum (of string)

Must be one of:

"INSERTED"
"REGISTERED"
"CC_OUTCOME"
"RELEASED"
"IVISTO"
"IRILDES"
"CANCELED"

Type: null

The customer code.

Type: string Default: null

The customer code will be provided by Laghezza

Example:

"ACME"

The customer VAT.

Default: null

The customer VAT

Type: string

Type: null

Example:

"00123345562"

The declaration customer reference.

Default: null

The customer reference of the shipment in the declaration.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"121212/A"

The dossier customer reference.

Default: null

The customer reference of the shipment in the dossier.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"B232323"

The declaration MRN.

Default: null

The Movement Reference Number of the declaration, if assigned.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"26ITQSS01AB12345R0"

The declaration LRN.

Default: null

The Local Reference Number of the declaration, if assigned.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"B232323"

The main regime of the customs declaration.

Default: null

Refer to Box 37/a of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"4000"

"1000"

The national regime of the customs declaration.

Default: null

Refer to Box 37/b of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"A01"

"C01"

The shipment declaration type.

Default: null

Refer to Box 1 of Commission Delegated Regulation (EU) 2016/341.

Any of

DeclarationType
Option 2

DeclarationType

Type: object
No Additional Properties

The first subdivision.

Default: null

In the first subdivision, enter the relevant Union code from Appendix D1.

Any of

Option 1
Option 2

Type: string

Must be at least 2 characters long

Must be at most 2 characters long

Type: null

Examples:

"IM"

"EX"

The second subdivision.

Default: null

In the second subdivision, enter the type of declaration using the relevant Union code from Appendix D1.

Any of

Option 1
Option 2

Type: string

Must be at least 1 characters long

Must be at most 1 characters long

Type: null

Example:

"A"

The third subdivision.

Default: null

In the third subdivision, enter the relevant Union code from Appendix D1.

Any of

Option 1
Option 2

Type: string

Must be at most 5 characters long

Type: null

Examples:

"T1"

"T2"

Type: null

The EORI of the person or the company.

Default: null

Only EU, The EORI of the person or the company.

Any of

Option 1
Option 2

Type: string

Must be at most 18 characters long

Type: null

Example:

"IT00852040112"

The name of the person or the company.

Default: null

Any of

Option 1
Option 2

Type: string

Must be at most 150 characters long

Type: null

Example:

"Laghezza S.p.A."

The registration date.

Default: null

The date when the declaration received an MRN.

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

Example:

"2026-01-20"

The number of the deferred payment account.

Default: null

Refer to Box 48 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"12345A"

The registration Customs office.

Default: null

Any of

Option 1
Option 2

Type: string

Must be at least 8 characters long

Must be at most 8 characters long

Type: null

Example:

"IT068100"

The total value of the goods and its currency.

Default: null

Refer to Box 22 of Commission Delegated Regulation (EU) 2016/341.

Any of

Amount
Option 2

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Type: null

The consignee-receiver of the goods.

Default: null

Refer to Box 8 of Commission Delegated Regulation (EU) 2016/341.

Any of

PersonOrCompany
Option 2

PersonOrCompany

Type: object

Eori

Any of

Option 1
Option 2

Type: string

Type: null

Name

Any of

Option 1
Option 2

Type: string

Type: null

Address

Any of

Option 1
Option 2

Type: string

Type: null

City

Any of

Option 1
Option 2

Type: string

Type: null

Postal Code

Any of

Option 1
Option 2

Type: string

Type: null

Province

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Country

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

The consignor-sender of the goods.

Default: null

Refer to Box 2 of Commission Delegated Regulation (EU) 2016/341.

Any of

PersonOrCompany
Option 2

PersonOrCompany

Type: object

Eori

Any of

Option 1
Option 2

Type: string

Type: null

Name

Any of

Option 1
Option 2

Type: string

Type: null

Address

Any of

Option 1
Option 2

Type: string

Type: null

City

Any of

Option 1
Option 2

Type: string

Type: null

Postal Code

Any of

Option 1
Option 2

Type: string

Type: null

Province

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Country

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Items

Type: array Default: []
No Additional Items

Each item of this array must be:

Item

Type: object
No Additional Properties

The number of the current item.

Type: integer

Refer to Box 32 of Commission Delegated Regulation (EU) 2016/341.

Value must be greater or equal to 1

Examples:

Taxes

Type: array
No Additional Items

Each item of this array must be:

ItemTax

Type: object
No Additional Properties

Code

Any of

Option 1
Option 2

Type: string

Type: null

Base

Any of

Option 1
Option 2

Type: number

Value must be greater or equal to 0.0

Type: null

Rate

Any of

Option 1
Option 2

Type: number

Value must be greater or equal to 0.0

Type: null

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Any of

PaymentMethod
Option 2

PaymentMethod

Type: enum (of string)

Must be one of:

"E"
"F"
"G"
"A"
"L"
"R"
"S"
"D"
"T"

Type: null

Default: null

Any of

TaxCalculation
Option 2

TaxCalculation

Type: enum (of string)

Must be one of:

"PERCENTAGE"
"MULTIPLICATIVE"

Type: null

Item containers list.

Type: array Default: []

The list of containers involved in the current item*.

No Additional Items

Each item of this array must be:

Container

Type: object
No Additional Properties

The container code.

Type: string

Example:

"MSCU1234567"

The container type.

Default: null

Refer to ISO 6346

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"40HC"

The list of container seals.

Default: []

Any of

Option 1
Option 2

Type: array of string
No Additional Items

Each item of this array must be:

Type: string

Type: null

Example:

[
    "S123456",
    "S123457"
]

Item documents list.

Default: []

Refer to Box 44 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: array
No Additional Items

Each item of this array must be:

ItemDocument

Type: object
No Additional Properties

The code of the document

Type: string

Examples:

"INVOICE"

"N380"

The reference of the document

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"FT_12a"

The country of the document

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"IT"

The year of the document

Default: null

Any of

Option 1
Option 2

Type: integer

Type: null

Example:

"2026"

Type: null

The customs heading - hs code of the goods.

Default: null

Refer to Box 33 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Must be at most 12 characters long

Type: null

Example:

"84818081"

The description of the goods.

Default: null

Refer to Box 31 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"Plug valves for pipes"

The country code of origin.

Default: null

Refer to Box 34A of Commission Delegated Regulation (EU) 2016/341.The country code must be represented in ISO 3166-1 alpha-2.

Any of

Option 1
Option 2

Type: string

Must be at most 2 characters long

Type: null

Example:

"CN"

The country code of origin.

Default: null

Refer to Box 34A of Commission Delegated Regulation (EU) 2016/341.The country code must be represented in ISO 3166-1 alpha-2.

Any of

Option 1
Option 2

Type: string

Must be at most 2 characters long

Type: null

Example:

"CN"

The amount of the goods for this item.

Default: null

Refer to Box 46 of Commission Delegated Regulation (EU) 2016/341.

Any of

Amount
Option 2

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Type: null

The amount of the goods for this item.

Default: null

Refer to Box 46 of Commission Delegated Regulation (EU) 2016/341.

Any of

Amount
Option 2

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Type: null

The item gross mass in kilograms.

Default: null

Refer to Box 35 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: number

Value must be greater or equal to 0.0

Type: null

Examples:

2.5

The item net mass in kilograms.

Default: null

Refer to Box 38 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: number

Value must be greater or equal to 0.0

Type: null

Examples:

2.5

The type of packages.

Default: null

Refer to Box 31 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"PK"

"CT"

The number of packages.

Default: null

Refer to Box 31 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: integer

Value must be greater or equal to 0

Type: null

Examples:

The quantity expressed in the unit laid down in the goods nomenclature.

Default: null

Refer to Box 41 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: number

Value must be greater or equal to 0.0

Type: null

Example:

20.0

Default: null

Any of

A93
Option 2

A93

Type: object

Number

Any of

Option 1
Option 2

Type: string

Type: null

Year

Any of

Option 1
Option 2

Type: integer

Type: null

Customs Office

Any of

Option 1
Option 2

Type: string

Type: null

Deferred Payment Account

Any of

Option 1
Option 2

Type: string

Type: null

Payments

Type: array
No Additional Items

Each item of this array must be:

A93Payment

Type: object

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Expiration Date

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

PaymentMethod

Type: enum (of string)

Must be one of:

"E"
"F"
"G"
"A"
"L"
"R"
"S"
"D"
"T"

Description

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Release information.

Default: null

Information about controlcircuitoutcome, relaese code and date_date

Any of

Release
Option 2

Release

Type: object

Default: null

Any of

ControlCircuitOutcome
Option 2

ControlCircuitOutcome

Type: enum (of string)

Must be one of:

"CA"
"VM"
"CD"
"CS"
"UNKNOWN"

Type: null

Release Code

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Release Date

Default: null

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

A93

Type: array Default: []
No Additional Items

Each item of this array must be:

A93

Type: object

Number

Any of

Option 1
Option 2

Type: string

Type: null

Year

Any of

Option 1
Option 2

Type: integer

Type: null

Customs Office

Any of

Option 1
Option 2

Type: string

Type: null

Deferred Payment Account

Any of

Option 1
Option 2

Type: string

Type: null

Payments

Type: array
No Additional Items

Each item of this array must be:

A93Payment

Type: object

Amount

Type: object

The amount value.

Any of

Option 1
Option 2

Type: number

Type: null

The amount currency.

Refer to ISO 4217

Any of

Option 1
Option 2

Type: string

Type: null

Examples:

"EUR"

"USD"

Expiration Date

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

PaymentMethod

Type: enum (of string)

Must be one of:

"E"
"F"
"G"
"A"
"L"
"R"
"S"
"D"
"T"

Description

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

The office of exit or entry.

Default: null

Refer to Box 29 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Must be at least 8 characters long

Must be at most 8 characters long

Type: null

Example:

"IT068100"

Default: null

Any of

Ivisto
Option 2

Ivisto

Type: object

Status

Any of

Option 1
Option 2

Type: string

Type: null

Exit Date

Default: null

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

Exit Customs Office

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Default: null

Any of

Irildes
Option 2

Irildes

Type: object

Status

Any of

Option 1
Option 2

Type: string

Type: null

Arrival Date

Default: null

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

Arrival Customs Office

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

The release by item information.

Default: false

The declaration has a release by item?

Any of

Option 1
Option 2

Type: boolean

Type: null

Example:

false

Release

Type: array Default: []
No Additional Items

Each item of this array must be:

Release

Type: object

Default: null

Any of

ControlCircuitOutcome
Option 2

ControlCircuitOutcome

Type: enum (of string)

Must be one of:

"CA"
"VM"
"CD"
"CS"
"UNKNOWN"

Type: null

Release Code

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Release Date

Default: null

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

The country of dispatch/export.

Default: null

Refer to Box 15 of Commission Delegated Regulation (EU) 2016/341. The country code must be represented in ISO 3166-1 alpha-2.

Any of

Option 1
Option 2

Type: string

Must be at most 2 characters long

Type: null

Example:

"IT"

The country code of destination.

Default: null

Refer to Box 17 of Commission Delegated Regulation (EU) 2016/341.The country code must be represented in ISO 3166-1 alpha-2.

Any of

Option 1
Option 2

Type: string

Must be at most 2 characters long

Type: null

Example:

"US"

The transport mode info.

Default: null

The transport mode for the goods: SHIP, TRAIN, PLANE, ...

Any of

TransportMode
Option 2

TransportMode

Type: enum (of string)

Must be one of:

"SHIP"
"TRAIN"
"TRUCK"
"PLANE"
"POSTAL"
"PRIVATE"

Type: null

Example:

"SHIP"

The transport vehicle info.

Default: null

Info about the transport vehicle for the goods.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"MSC SHIPNAME"

The transport date info.

Default: null

Info about the transport date for the goods.

Any of

Option 1
Option 2

Type: stringFormat: date

Type: null

Example:

"2026-01-20"

The delivery terms.

Default: null

Refer to Box 20 of Commission Delegated Regulation (EU) 2016/341.

Any of

Option 1
Option 2

Type: string

Type: null

Example:

"FCA LA SPEZIA"

Internal Shipment Reference

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Attachments

Type: array Default: []
No Additional Items

Each item of this array must be:

CustomsDeclarationAttachment

Type: object

Filename

Any of

Option 1
Option 2

Type: string

Type: null

Content Type

Any of

Option 1
Option 2

Type: string

Type: null

Url

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Binary

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Year

Default: null

Any of

Option 1
Option 2

Type: integer

Type: null

Identification Number

Default: null

Any of

Option 1
Option 2

Type: string

Type: null

Any of

CustomsDeclarationAttachmentCategory
Option 2

CustomsDeclarationAttachmentCategory

Type: enum (of string)

Must be one of:

"DICHIARAZIONE_DOGANALE"
"PROSPETTO_SVINCOLO"
"PROSPETTO_SINTESI"
"PROSPETTO_CONTABILE"
"DAE"
"DAT"
"IVISTO"
"DELIVERY_ORDER"
"XML_RESPONSE"
"XML_REQUEST"
"XML_IVISTO"

Type: null

Is this a revision?.

Default: null

TRUE when the declaration is a revision of an existing declaration.

Any of

Option 1
Option 2

Type: boolean

Type: null

Examples:

"TRUE"

"FALSE"

Is this a received declaration?.

Default: null

TRUE when the declaration is received by another broker.

Any of

Option 1
Option 2

Type: boolean

Type: null

Examples:

"TRUE"

"FALSE"

Was this revised?.

Default: null

TRUE when the declaration has been revised by another revision declaration

Any of

Option 1
Option 2

Type: boolean

Type: null

Examples:

"TRUE"

"FALSE"

Was this cancelled?.

Default: null

TRUE when the declaration was cancelled

Any of

Option 1
Option 2

Type: boolean

Type: null

Examples:

"TRUE"

"FALSE"

PublicSimpleCustomsDeclaration

schema_id Required

The Id of the JSON schema.

status

Status information.

Any of

CustomsDeclarationStatus

Must be one of:

customer_code

The customer code.

customer_vat

The customer VAT.

Any of

customer_shipment_reference

The declaration customer reference.

Any of

dossier_customer_shipment_reference

The dossier customer reference.

Any of

mrn

The declaration MRN.

Any of

lrn

The declaration LRN.

Any of

regime

The main regime of the customs declaration.

Any of

regime_national

The national regime of the customs declaration.

Any of

declaration_type

The shipment declaration type.

Any of

DeclarationType

first_subdivision

The first subdivision.

Any of

second_subdivision

The second subdivision.

Any of

third_subdivision

The third subdivision.

Any of

declarant_eori

The EORI of the person or the company.

Any of

declarant_name

The name of the person or the company.

Any of

registration_date

The registration date.

Any of

deferred_payment_account

The number of the deferred payment account.

Any of

customs_office

The registration Customs office.

Any of

total_amount

The total value of the goods and its currency.

Any of

Amount

amount Required

The amount value.

Any of

currency Required

The amount currency.

Any of

consignee

The consignee-receiver of the goods.

Any of

PersonOrCompany

eori Required

Eori

Any of

name Required

Name

Any of

address Required