C00 Customs Interface Overview

Status: DRAFT → stable: interfaces to/from C@TS under construction: C06 + C07 new interfaces to/from Heine-Zoll

1. Content / Business Context

This section and its subpages provide an overview of all IT systems required for customs processes and the interfaces to be exchanged.

2. Informationflow

flow

3. BreakUp of logisticsProductId in direction Hermes/Heine

To maintain functionality in legacy systems (here Hermes C@ts, or Heine customs system), which cannot be adapted to erpProductID, or this would be domain technically foreign -→ there is an agreement for product signaling by sending the 'otto'-wide known triplex (Company + ItemNo + Size) along with the logisticsProductId. The item detection is thus simplified and does not need to be changed in target systems. FINE takes care of this functionality of "ID-BreakUp". In any reply, the customs system will then only return the logisticsProductId that was prior given in. C.f. following illustration also:

flow

4. Datamodel for the messages in the error topics

Property	Type	Description
(Root)	object
eventId	string (uuid)
traceId	string (uuid)
eventTime	string (date-time)
eventType	(enum)	Any of: [ "LogisticsProductIdNotFound", "InternalServerError" ]
data	object
message	string

Property

Type

Description

(Root)

object

eventId

string (uuid)

traceId

string (uuid)

eventTime

string (date-time)

eventType

(enum)

Any of: [ "LogisticsProductIdNotFound", "InternalServerError" ]

data

object

message

string

4.1. Schema

Table 1. Version WMS to FINE
Version	Number	File	Published on	Changes
current version	0.1	Download	19.06.2023	intitiale Version
previous version
coming version

Interface FINE to Producers

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "$comment": "Schema for the messages inside the error topics of the customs interface",
    "$id": "https://doc.fine.gcp.osp-dev.de/registry/Customs/CustomsErrorResponse.v0.1.schema.json",
    "type": "object",
    "properties": {
        "eventId": {
            "type": "string",
            "format": "uuid"
        },
        "traceId": {
            "type": "string",
            "format": "uuid"
        },
        "eventTime": {
            "type": "string",
            "format": "date-time"
        },
        "eventType": {
            "enum": [
                "LogisticsProductIdNotFound",
                "InternalServerError"
            ]
        },
        "data": {
            "type": "object",
            "properties": {
                "message": {
                    "type": "string"
                }
            }
        }
    }
}

Last updated: Fri, 25 Apr 2025 01:44:50 UTC