Serialization

The “serialization-service” provides methods for creating SGTIN and LGTIN

Requirements

  1. User's session must contain field “current_participant”.
{
  "id": "urn:authenticateit:user:email:my@gmail.com",
  "name": "ivan",
  "roles": [
    "user"
  ],
  "ticket": "7b758d11-a597-44ae-8ab4-dd3cf864e20f",
  "current_participant": {
    "id": "urn:epc:sgln:0614141.12345.1"
  }
}
  1. This participant must be presented in doc_storage with “type” field equals to “outsource” or “manufacturer”. Document also must provide a list of company prefixes
{
  "_id": "urn:epc:sgln:0614141.12345.1",
  "type": "participant",
  "participant_type": [
    "manufacturer"
  ],
  "company_prefix": [
    "0614141"
  ]
}

Create SGTINs or LGTINs with requested paremeters

Start serialization process with the given parameters. Responds with JSON object containing serialization task id. The returned identifier may be used to request task status.

GS1 application identifiers (see here for additional information) may be included in the generated SGTINs or LGTINs. The following AIs are supported:

  • Date AIs 11–17. Data for these AIs is a 6 digits string representing date in YYMMDD format. E.g., June 11, 2019 will be represented as 190611.
  • Measurement AIs 310–369. Data for these AIs is a 6 digits string representing the measurement. The first digit in the data indicates the number of decimal places. The rest of the digits represent the measured value. E.g., net weight of 1.23 kg will be represented as AI 310 with data 200123.
  • Additional product identification AI 240. Data for this AI is a string up to 30 characters long. The following characters and character ranges are allowed in the data: !–", %–/, 0–9, A–Z, _ and a–z.
  • Company internal information AIs 91–99. Data for these AIs is a string up to 90 characters long. The same characters are allowed in the data as in AI 240 (see above).
POST /serialization-service/serialize
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
gtin base gtin “00614141791304”
format serialization format “gs1” or “epc”
type serialization type “sgtin” or “lgtin”
count requested number integer
data_type "numeric", "alphanumeric" or "all"
length integer from 1 to 20
sequence sequence option “ordered” or “random”
owner owner of serialized gtin not required
settings export settings not required, if not presented - use default
settings.labels_as_titles labels as titles in csv header “yes” or “no”, default “no”
settings.code gs1 code in csv “yes” or “no”, default “yes”
settings.owner owner id in csv “yes” or “no”, default “no”
settings.delimiter delimiter in csv default "|"
settings.name export product name in csv “yes” or “no”, default “no”
ai GS1 AI to be included in SGTIN or LGTIN List of application identifiers.
participant Participant identifier Assing child supply chain participant as SGTIN owner
location Business location identifier Assing business location owner as SGTIN owner
source Additional source in SGTIN or LGTIN doc single source object
sources Additional sources in SGTIN or LGTIN doc list of source objects
Example Request
{
  "gtin": "02933451000009",
  "name": "Butter",
  "type": "lgtin",
  "format": "epc",
  "count": 2,
  "ai": [
    "12180608"
  ],
  "sequence": "random",
  "length": 12,
  "data_type": "alphanumeric",
  "source": {
    "data": [
      {
        "text": {
          "title": "44",
          "text": "444444"
        }
      },
      {
        "text": {
          "title": "55",
          "text": "555555"
        }
      }
    ],
    "conditions": {
      "country": "036",
      "language": "zh"
    }
  }
}

{
  "gtin": "02933451000009",
  "name": "Shoes",
  "type": "sgtin",
  "format": "gs1",
  "count": 3,
  "ai": [
    "13180609",
    "15180602",
    "16180609",
    "3110000033",
    "17180602"
  ],
  "sequence": "random",
  "length": 12,
  "data_type": "numeric",
  "sources": [
    {
      "conditions": {},
      "data": [
        {
          "text": {
            "title": "text",
            "text": "Update SGTIN widget",
            "markdown": false
          }
        },
        {
          "link": {
            "text": "Link",
            "url": "http://www.facebook.com/shping"
          }
        }
      ]
    }
  ]
}
Example Response
{
  "id": "ff79bfae-3713-49ec-8551-2f29bb4d3b72"
}

Get status of serialization

Get status of previously started serialization task.

GET /serialization-service/serialize/:task_id
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
task_id string Serialization task identifier.
Example Response
{
  "progress": 100,
  "status": "started"
}

{
  "status": "done",
  "link": "https://dev-test-cdn.shping.com/2016-12-04T19:44:49Z-b3c59bfa-4f8e-431e-b445-de2417cdffa8.csv"
}

{
  "error": "Serialization not has been started"
}

Get serialization tasks

Returns list of previously started serialization tasks.

Number of returned tasks may be limited with the limit parameter (default valus is 100). Number of tasks may be skipped from the list with the offset parameter (0 by default).

Returned tasks may be filtered by status (either started or done), gtin, name (tasks for GTINs with product name matching this string).

The resulting list may be sorted. Parameter sort_by should be used to specify sorting field (start_time, gtin, name or status). Sorting order may be specified with sort_order parameter (asc for ascending order and desc for descending order).

GET /serialization-service/tasks
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
offset Skip number of tasks from the resulting list.
limit Limite the number of tasks in the resulting list.
from_date Only tasks started after this date.
to_date Only tasks started before this date.
status Only tasks with this status.
gtin Only tasks for the GTIN.
name Only tasks for products matching this name.
sort_by Sort tasks by field.
sort_order Ascending or descending sort order.
Example Response
{
  "id": "task_serialization",
  "serialization_list": [
    {
      "ai": "02",
      "check_digit": "4",
      "company_prefix": "0614141",
      "count": 10,
      "end_time": "2016-12-03T13:00:43Z",
      "epc_header": "urn:epc:id:lgtin:0614141.079130.",
      "gs1_header": "020061414179130410",
      "gtin": "00614141791304",
      "indicator": "0",
      "item_reference": "79130",
      "link": "https://dev-test-cdn.shping.com/2016-12-03T13:00:40Z-6d20f9c0-811b-4829-b899-9512ef4ad356.csv",
      "owner": "urn:epc:sgln:0614141.12345.1",
      "participant": "urn:epc:sgln:0614141.123451",
      "sequence": "random",
      "settings": {
        "code": "no",
        "delimiter": "|",
        "labels_as_titles": "yes",
        "name": "yes",
        "owner": "yes"
      },
      "start_time": "2016-12-03T13:00:40Z",
      "type": "lgtin",
      "user": "urn:epc:sgln:0614141.12345.1"
    },
    {
      "ai": "02",
      "check_digit": "4",
      "company_prefix": "0614141",
      "count": 10,
      "end_time": "2016-12-03T10:18:50Z",
      "epc_header": "urn:epc:id:lgtin:0614141.079130.",
      "gs1_header": "020061414179130410",
      "gtin": "00614141791304",
      "indicator": "0",
      "item_reference": "79130",
      "last_element": "urn:epc:id:lgtin:0614141.079130.0000010030",
      "link": "https://dev-test-cdn.shping.com/2016-12-03T10:18:25Z-6efdca22-e049-4f6d-9faa-ac4b7c739e1f.csv",
      "owner": "urn:epc:sgln:0614141.12345.1",
      "participant": "urn:epc:sgln:0614141.12345.1",
      "sequence": "ordered",
      "settings": {
        "code": "no",
        "delimiter": "|",
        "labels_as_titles": "yes",
        "name": "yes",
        "owner": "yes"
      },
      "start_time": "2016-12-03T10:18:25Z",
      "type": "lgtin",
      "user": "urn:epc:sgln:0614141.12345.1"
    }
  ]
}

Shipping Containers

All endpoints require serialization_admin role for the calling user.

Import SSCCs

Create SSCC documents in the system from provided SSCC codes. Accepts JSON object representation of the import task parameters, starts the task and responds with id of the task. Import description has the following fields:

  • id — a single SSCC or a list of SSCC codes to be imported. SSCCs as GS1 codes and SSCCs in EPC format are accepted.
  • company_prefix — import only SSCCs which have company prefix compatible with the specified prefix. The prefix must be in participant's list of prefixes or participant should have a wildcard (*) prefix *.

Only SSCCs which are not already present will be created. Company prefix of SSCCs should correspond to current participant's company prefixes.

POST /serialization-service/packaging/tasks
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
Example Request
{
  "id": [
    "urn:epc:id:sscc:9212345.0000000001",
    "urn:epc:id:sscc:1111111.1111111111",
    "00193423360000001230",
    "00111111111111111118"
  ]
}
Example Response
{
  "id": "d78c69d3-5a64-4fed-bf93-5621be12aece"
}

Generate SSCCs

Generate list of random or serial SSCCs for current participant. Accepts JSON object representation of the generation task parameters, starts the task and responds with id of the task. Generate task description has the following fields:

  • count — positive number of SSCCs to be generated. This parameter is required and has no default value.
  • sequence — either ordered or random. The default value is random.
  • company_prefix — use this company prefix in generated SSCCs. The prefix must be accessible by current participant, or current participant should have a wildcard prefix *. The parameter is optional, first valid company prefix of participant will be used, if unspecified.
  • serial_number — start ordered SSCCs from this serial number. Only applicable for the ordered sequence. Has no default value, must be specified explicitly if sequence is ordered.

In ordered mode, if generated SSCC is already present, next serial number will be tried.

POST /serialization-service/packaging/tasks
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
Example Request
{
  "count": 3,
  "sequence": "ordered",
  "company_prefix": "9212345",
  "serial_number": 1
}
Example Response
{
  "id": "344d2f8f-8aeb-4ae2-9cc7-954cbe3231d6"
}

Status of a SSCC Generation Task

Query status of SSCC import/generation task.

Task status representation has the total count of SSCCs to be created, number of already processed SSCCs in the progress field, list of already created SSCCs in the created field and the list of errors.

GET /serialization-service/packaging/tasks/:id
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
Example Response
{
  "count": 4,
  "created": [
     {
       "gs1_sscc": "00099111116915813129",
       "id": "urn:epc:id:sscc:9911111.0691581312"
     }
  ],
  "end_time": "2019-06-11T21:23:03Z",
  "errors": [
    {
      "error_id": "serialization-bad_sscc_prefix",
      "sscc": "00111111111111111118"
    },
    {
      "error_id": "serialization-bad_sscc_prefix",
      "sscc": "urn:epc:id:sscc:1111111.1111111111"
    },
    {
      "error_id": "serialization-sscc_exists",
      "sscc": "urn:epc:id:sscc:9212345.0000000001"
    }
  ],
  "id": "d78c69d3-5a64-4fed-bf93-5621be12aece",
  "progress": 4,
  "start_time": "2019-06-11T21:23:03Z",
  "status": "done"
}

Status of All SSCC Generation Tasks

Get status of all SSCC create/import tasks for the participant. Response has list of tasks. Each entry represents a single task (see Status of a Task endpoint for task representation).

GET /serialization-service/packaging/tasks
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
Example Response
{
  "tasks": [
    {
      "count": 4,
      "created": [
        {
          "gs1_sscc": "00099111116915813129",
          "id": "urn:epc:id:sscc:9911111.0691581312"
        }
      ],
      "end_time": "2019-06-11T21:23:03Z",
      "errors": [
        {
          "error_id": "serialization-bad_sscc_prefix",
          "sscc": "00111111111111111118"
        },
        {
          "error_id": "serialization-bad_sscc_prefix",
          "sscc": "urn:epc:id:sscc:1111111.1111111111"
        },
        {
          "error_id": "serialization-sscc_exists",
          "sscc": "urn:epc:id:sscc:9212345.0000000001"
        }
      ],
      "id": "d78c69d3-5a64-4fed-bf93-5621be12aece",
      "progress": 4,
      "start_time": "2019-06-11T21:23:03Z",
      "status": "done"
    }
  ]
}

Synchronous import/create SSCC

POST /serialization-service/packaging/sync
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket

Generate list of SSCCs for current participant.

  • count — positive number of SSCCs to be generated. This parameter is required and has no default value.
  • id — import SSCC code ot list of codes
Example Request. Generate 1 code
{
  "count": 1
}
Example Response
{
    "company_prefix": "7734170383",
    "count": 1,
    "created": [
        {
            "gs1_sscc": "00577341703831157974",
            "id": "urn:epc:id:sscc:7734170383.5115797"
        }
    ],
    "end_time": "2020-02-19T14:14:59Z",
    "progress": 1,
    "sequence": "random",
    "start_time": "2020-02-19T14:14:59Z",
    "status": "done"
}
Example Request. Import SSCC
{
  "id": ["00346079433414716042","00446079433414716049"]
}
Example Response
{
    "count": 2,
    "created": [
        {
            "gs1_sscc": "00446079433414716049",
            "id": "urn:epc:id:sscc:4607943.4341471604"
        },
        {
            "gs1_sscc": "00346079433414716042",
            "id": "urn:epc:id:sscc:4607943.3341471604"
        }
    ],
    "end_time": "2020-02-19T14:20:00Z",
    "progress": 2,
    "start_time": "2020-02-19T14:19:59Z",
    "status": "done"
}
Example Request. Import SSCC. Code already exist
{
  "id": "00246079433414716045"
}
Example Response
{
    "count": 1,
    "end_time": "2020-02-19T14:17:03Z",
    "errors": [
        {
            "error_id": "serialization-sscc_exists",
            "sscc": "00246079433414716045"
        }
    ],
    "progress": 1,
    "start_time": "2020-02-19T14:17:03Z",
    "status": "done"
}

Pack Items into a Container

Endpoint to package existing SGTIN, LGTIN or children SSCC items into a container.

Item identifiers must be provided in items field in request body. Container is identified by SSCC in request URL.

Responds with list of sucessfully packed items and with the list of errors.

POST /serialization-service/packaging/container/:sscc/pack
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
sscc string Container identifier to pack into
invoiceNumber string Invoice Number
invoiceDate string Invoice Date
gtin string Base GTIN
reflexNumber any Reflex Invoice Number
Example Request
{
  "items": [
    "urn:epc:id:sscc:9212345.0000000001",
    "urn:epc:id:sscc:1111111.1111111111",
    "urn:epc:id:sgtin:652086.0004527.000000000000001"
  ],
  "invoiceNumber": "SomeNum",
  "invoiceDate": "SomeDate",
  "gtin": "00000000000000",
}
Example Response
{
  "packed": [
    "urn:epc:id:sscc:9212345.0000000001",
    "urn:epc:id:sgtin:652086.0004527.000000000000001"
  ],
  "errors": [
    {
      "item": "urn:epc:id:sscc:1111111.1111111111",
      "error_id": "serialization-bad_pack_item"
    }
  ]
}

Unpack Container

Endpoint to explicitly mark a container as unpacked. Responds with no content.

POST /serialization-service/packaging/container/:sscc/pack
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
sscc string Container to unpack
Example Request
{
}

Query Participant Packaging Settings

Endpoint for system participant to query packaging settings of a serialization admin participant.

Packaging settings consists of container_company_prefix list (participant is allowed to pack items into containers with these prefixes) and item_company_prefix list (participant is allowed to pack items with these prefixes).

GET /serialization-service/packaging/participant/:participant_id/settings
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
participant_id string Participant identifier
Example Response
{
  "container_company_prefix": [
    "9212345",
    "9523452"
  ],
  "item_company_prefix": [
    "9212345"
  ]
}

Update Participant Packaging Settings

Endpoint for system participant to update packaging settings of a serialization admin participant. container_company_prefix and item_company_prefix lists may be updated. Responds with the updated settings.

PUT /serialization-service/packaging/participant/:participant_id/settings
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
participant_id string Participant identifier
Example Request
{
  "item_company_prefix": [
    "9212345",
    "9523452"
  ]
}
Example Response
{
  "container_company_prefix": [
    "9212345",
    "9523452"
  ],
  "item_company_prefix": [
    "9212345",
    "9523452"
  ]
}

Aggregation

POST /serialization-service/aggregation
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session ticket
gtin gtin Source GTIN
quantity pos_int Required: Quantity of sgtin's
doc string Will be attached to packed sgtin
invoiceNumber string Query parameter
ownerInn string Query parameter
invoiceDate string Query parameter
scenarioTT 0 or 1 Required: Will be attached to packed sgtin
aggregTT 0 or 1 Will be attached to packed sgtin
pcb pos_int Required: Quantity of sgtin's in pack
type string sync (default) or async
query string RSQL query
op string RSQL operator (AND or OR)

query can be used for select of sgtins instead of invoiceNumber, ownerInn, invoiceDate

Example Request (RSQL sync)
{
  "quantity" :10,
  "scenarioTT": 1,
  "aggregTT": 1,
  "query": "field_370a21b5f7f0c15d6dfce2a406dce5d86e74ca71==\"owner111\";field_64fdc5235d65719db2313923ad30ce7fda154808==\"invoice111\"",
 "pcb":5}
}
Example Request (RSQL async)
{
  "quantity" :10,
  "scenarioTT": 1,
  "aggregTT": 1,
  "query": "field_370a21b5f7f0c15d6dfce2a406dce5d86e74ca71==\"owner111\";field_64fdc5235d65719db2313923ad30ce7fda154808==\"invoice111\"",
 "type":"async",
 "pcb":5}
}
Example Request (sync)
{
 "gtin":"03348901300124",
 "quantity" :4,
 "doc":"doc567",
 "invoiceNumber": "invoiceNumber567",
 "ownerInn": "ownerInn567",
 "invoiceDate":"2019-04-04",
 "scenarioTT":0,
 "pcb":2
}
Example Request (async)
{
 "gtin":"03348901300124",
 "quantity" :2,
 "doc":"doc567",
 "invoiceNumber": "invoiceNumber567",
 "ownerInn": "ownerInn567",
 "invoiceDate":"2019-04-04",
 "scenarioTT":0,
 "pcb":1,
 "type":"async"
}
Example Response (sync)
[
    {
        "code": "010334890130012421(gG5GJfSz+1j)\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4=",
        "gs1_sscc": "00077341703839200820",
        "sgtin": "urn:epc:id:sgtin:3348901.030012.(gG5GJfSz+1j)",
        "sscc": "urn:epc:id:sscc:7734170383.0920082"
    },
    {
        "code": "010334890130012421*kM)uaZjRchho\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4=",
        "gs1_sscc": "00077341703839200820",
        "sgtin": "urn:epc:id:sgtin:3348901.030012.*kM)uaZjRchho",
        "sscc": "urn:epc:id:sscc:7734170383.0920082"
    },
    {
        "code": "010334890130012421&1iV>*I',M:!/\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4=",
        "gs1_sscc": "00077341703830028614",
        "sgtin": "urn:epc:id:sgtin:3348901.030012.&1iV>*I',M:!/",
        "sscc": "urn:epc:id:sscc:7734170383.0002861"
    },
    {
        "code": "010334890130012421%:5sO<JhE:d3u\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4=",
        "gs1_sscc": "00077341703830028614",
        "sgtin": "urn:epc:id:sgtin:3348901.030012.%:5sO<JhE:d3u",
        "sscc": "urn:epc:id:sscc:7734170383.0002861"
    }
]
Example Response (async)
{
    "id": "1c55090c-205c-45c2-8015-d2cfc0455f52@aggregation_task"
}

Read aggregation tasks

GET /serialization-service/aggregation
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session ticket
chunk_id string Chunk ID of aggregation tasks list
Example Response
{
    "next": "urn:authenticateit:participant:804355519238230@aggregation_tasks@59e4f585-2d95-4bcb-badf-088830c60120",
    "tasks": [
        {
            "end_time": "2019-11-26T20:38:01Z",
            "id": "1c55090c-205c-45c2-8015-d2cfc0455f52@aggregation_task",
            "link": "https://dev-cdn.shping.com/2019/11/26/1c55090c-205c-45c2-8015-d2cfc0455f52@aggregation_task.csv",
            "progress": 2,
            "start_time": "2019-11-26T20:37:58Z",
            "status": "done",
            "total": 2
        }
    ]
}
Example Response
{
    "next": null,
    "tasks": [
        {
            "end_time": "2019-11-26T15:32:16Z",
            "id": "dc019878-fda6-4a39-90e8-65179361ba74@aggregation_task",
            "link": "https://dev-cdn.shping.com/2019/11/26/dc019878-fda6-4a39-90e8-65179361ba74@aggregation_task.csv",
            "progress": 1,
            "start_time": "2019-11-26T15:32:14Z",
            "status": "done",
            "total": 1
        }
    ]
}

Read aggregation task

GET /serialization-service/aggregation/:id
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session ticket
id string Aggregation task id
Example Response
{
    "end_time": "2019-11-25T21:14:16Z",
    "id": "2226d3d5-c69e-4c9f-938b-4a92c0577540@aggregation_task",
    "link": "https://dev-cdn.shping.com/2019/11/25/2226d3d5-c69e-4c9f-938b-4a92c0577540@aggregation_task.csv",
    "progress": 4,
    "start_time": "2019-11-25T21:08:40Z",
    "status": "done",
    "total": 4
}
Example Response
{
    "end_time": null,
    "id": "034d8510-29ce-4c68-b3dd-5a5f3b3882b1@aggregation_task",
    "progress": 41,
    "start_time": "2019-11-26T20:56:10Z",
    "status": "started",
    "total": 62
}

Import sgtins

Import serialized products.

POST /serialization-service/import/sgtins
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
gtin base gtin Required: Base GTIN
task_id string Required: Task ID
quantity pos_integer Required: Total sgtins quantity for the task
sgtins list Required: List of sgtins in GS1 format
settings object Settings object
settings.labels_as_titles yes or no Labels as titles in csv header. Default no
settings.code yes or no GS1 code in csv. Default yes
settings.owner yes or no Owner id in csv. Default no
settings.delimiter string Default "|"
settings.name yes or no Export product name in csv. Default no
sources sources_object Additional sources

If the response is empty, then quantity of loaded SGTINS lower than quantity value in request.

Example Request
{
  "sgtins": [
    "010334890087198421UKy;UoI+lAOY6\u001d91EE05\u001d925sqJbVM5XQm2Gep4rUjZJgfU88b1RDyYwxud7zb10r0=",
    "010334890087198421n=uL2(cGl0\"iE\u001d91EE05\u001d92lbePGb4f4LYgietArtEc3KlIKqRVdqnNC+cOz+kddcs=",
    "010334890087198421j_r'b*k?YBf9n\u001d91EE05\u001d92u5injthuxUaXp2NIZjFOcQABYjiBblm24pFuuaWWXxU=",
    "010334890087198421VQ*jD!UF:4%V2\u001d91EE05\u001d92paYoXTV5XBHsdfM19oe/bO45k1FBx5L8kZ+jLsOhdkA=",
    "010334890087198421+>nec)I7DG&Gg\u001d91EE05\u001d92zTJ6EIcH9NKyXatK5h1ouMyRAuUq5L78jcjtOlX73Fk=",
    "0103348900871984211Ky;UoI+lAOY6\u001d91EE05\u001d925sqJbVM5XQm2Gep4rUjZJgfU88b1RDyYwxud7zb10r0=",
    "0103348900871984212=uL2(cGl0\"iE\u001d91EE05\u001d92lbePGb4f4LYgietArtEc3KlIKqRVdqnNC+cOz+kddcs=",
    "0103348900871984213_r'b*k?YBf9n\u001d91EE05\u001d92u5injthuxUaXp2NIZjFOcQABYjiBblm24pFuuaWWXxU=",
    "0103348900871984214Q*jD!UF:4%V2\u001d91EE05\u001d92paYoXTV5XBHsdfM19oe/bO45k1FBx5L8kZ+jLsOhdkA=",
    "0103348900871984215>nec)I7DG&Gg\u001d91EE05\u001d92zTJ6EIcH9NKyXatK5h1ouMyRAuUq5L78jcjtOlX73Fk=",
    "0103348900871984216Ky;UoI+lAOY6\u001d91EE05\u001d925sqJbVM5XQm2Gep4rUjZJgfU88b1RDyYwxud7zb10r0=",
    "0103348900871984217=uL2(cGl0\"iE\u001d91EE05\u001d92lbePGb4f4LYgietArtEc3KlIKqRVdqnNC+cOz+kddcs=",
    "0103348900871984218_r'b*k?YBf9n\u001d91EE05\u001d92u5injthuxUaXp2NIZjFOcQABYjiBblm24pFuuaWWXxU=",
    "0103348900871984219Q*jD!UF:4%V2\u001d91EE05\u001d92paYoXTV5XBHsdfM19oe/bO45k1FBx5L8kZ+jLsOhdkA=",
    "0103348900871984210>nec)I7DG&Gg\u001d91EE05\u001d92zTJ6EIcH9NKyXatK5h1ouMyRAuUq5L78jcjtOlX73Fk=",
    "010334890087198421aKy;UoI+lAOY6\u001d91EE05\u001d925sqJbVM5XQm2Gep4rUjZJgfU88b1RDyYwxud7zb10r0=",
    "010334890087198421b=uL2(cGl0\"iE\u001d91EE05\u001d92lbePGb4f4LYgietArtEc3KlIKqRVdqnNC+cOz+kddcs=",
    "010334890087198421c_r'b*k?YBf9n\u001d91EE05\u001d92u5injthuxUaXp2NIZjFOcQABYjiBblm24pFuuaWWXxU=",
    "010334890087198421dQ*jD!UF:4%V2\u001d91EE05\u001d92paYoXTV5XBHsdfM19oe/bO45k1FBx5L8kZ+jLsOhdkA=",
    "010334890087198421e>nec)I7DG&Gg\u001d91EE05\u001d92zTJ6EIcH9NKyXatK5h1ouMyRAuUq5L78jcjtOlX73Fk=",
    "010334890087198421fQ*jD!UF:4%V2\u001d91EE05\u001d92paYoXTV5XBHsdfM19oe/bO45k1FBx5L8kZ+jLsOhdkA=",
    "010334890087198421g>nec)I7DG&Gg\u001d91EE05\u001d92zTJ6EIcH9NKyXatK5h1ouMyRAuUq5L78jcjtOlX73Fk="
  ],
  "quantity": 22,
  "gtin": "03348900871984",
  "task_id": "198373d4-4d04-4c7f-9a5a-045b10c3bbc6",
  "sources": [
    {
      "conditions": {},
      "data": [
        {
          "text": {
            "markdown": false,
            "text": "invoiceNumber111111",
            "title": "invoiceNumber"
          }
        },
        {
          "text": {
            "markdown": false,
            "text": "ownerInn111111",
            "title": "ownerInn"
          }
        },
        {
          "text": {
            "markdown": false,
            "text": "2019-12-06",
            "title": "invoiceDate"
          }
        }
      ]
    }
  ],
  "settings": {
    "delimiter": "|"
  }
}
Example Response
{
  "id": "198373d4-4d04-4c7f-9a5a-045b10c3bbc6"
}

Missions

Create mission

POST /serialization-service/mission
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
client string Required: Client parameter
depo string Required: Depo parameter
msg_type string Required: Type parameter (GFP or GPK)
msg object or array Required: Message
Example Request
{
  "client": "SELDICO",
  "depo": "TKV",
  "msg_type": "GFP",
  "msg": [
    {
      "preparation_number": "10400051244",
      "order_number": "CHP-715211",
      "pallet_number": "871112227000001107", 
      "gtin": "03348900871984",
      "qty": "5"
    } 
  ]
}
Example Response
[
    {
        "epc_pallet_number": "urn:epc:id:sscc:7111222.8700000110",
        "id": "f8a5d45c-9a9f-4a7c-89c9-64985f4d922d",
        "pallet_number": "00871112227000001107",
        "preparation_number": "10400051244"
    }
]
Example Request
{
  "client": "SELDICO",
  "depo": "TKV",
  "msg_type": "GPK",
  "msg": [
    {
      "preparation_number": "10100051244",
      "order_number": "CHP-715211",
      "carton_number": "871112221000001105", 
      "pallet_number": "000000000000000000", 
      "gtin": "03348900871984",
      "qty": "5"
    },
    {
      "preparation_number": "10100051244",
      "order_number": "CHP-715211",
      "carton_number": "871112220000001108", 
      "gtin": "03348900871984",
      "qty": "5"
    } 
  ]
}
Example Response
[
    {
        "carton_number": "00871112221000001105",
        "epc_carton_number": "urn:epc:id:sscc:7111222.8100000110",
        "id": "4dd0f2f1-223d-4865-8f2e-97239099699e",
        "preparation_number": "10100051244"
    },
    {
        "carton_number": "00871112220000001108",
        "epc_carton_number": "urn:epc:id:sscc:7111222.8000000110",
        "id": "043d3c9d-9e69-4ba3-baf1-cdb5703f2a2b",
        "preparation_number": "10100051244"
    }
]
Example Request
{
  "client": "SELDICO",
  "depo": "TKV",
  "msg_type": "GPK",
  "msg": [
    {
      "preparation_number": "10200051244",
      "order_number": "CHP-715211",
      "carton_number": "871112223000001109", 
      "pallet_number": "871112223000011108", 
      "gtin": "03348900871984",
      "qty": "5"
    },
    {
      "preparation_number": "10200051244",
      "order_number": "CHP-715211",
      "carton_number": "871112224000001106", 
      "pallet_number": "871112223000011108", 
      "gtin": "03348900871984",
      "qty": "5"
    } 
  ]
}
Example Response
[
    {
        "carton_number": "00871112223000001109",
        "epc_carton_number": "urn:epc:id:sscc:7111222.8300000110",
        "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
        "id": "f2c6112b-1b8d-4a19-b426-91d4c3d24c6f",
        "pallet_number": "00871112223000011108",
        "preparation_number": "10200051244"
    },
    {
        "carton_number": "00871112224000001106",
        "epc_carton_number": "urn:epc:id:sscc:7111222.8400000110",
        "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
        "id": "426e906f-1251-4571-a252-18c6e3157294",
        "pallet_number": "00871112223000011108",
        "preparation_number": "10200051244"
    }
]

Read mission state

Workflow of read mission identifier by sscc code:
1) Get the schema (GET /index-service/index-schema) with the type sscc
2) find record where gs1_id = sscc code by RSQL
3) get mission identifier from mission_id field. If mission_id is NULL then there are no attached mission

POST /serialization-service/mission/state
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
mission string Required: Mission ID
Example Request
{ "mission": "10400051244" }
Example Response GFP
{
    "list": [
        {
            "carton_number": null,
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": null,
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8700000110",
            "gtin": "03348900871984",
            "id": "f8a5d45c-9a9f-4a7c-89c9-64985f4d922d",
            "mission_type": "GFP",
            "order_number": "CHP-715211",
            "pallet_number": "00871112227000001107",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10400051244",
            "qty": 5,
            "ts": "2020-02-05T13:38:59Z"
        }
    ],
    "mission_id": "10400051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request
{ "mission": "10100051244" }
Example Response GPK with SGTINs
{
    "list": [
        {
            "carton_number": "00871112221000001105",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8100000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "4dd0f2f1-223d-4865-8f2e-97239099699e",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        },
        {
            "carton_number": "00871112220000001108",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8000000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "043d3c9d-9e69-4ba3-baf1-cdb5703f2a2b",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        }
    ],
    "mission_id": "10100051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request
{ "mission": "10200051244" }
Example Response GPK with SSCCs
{
    "list": [
        {
            "carton_number": "00871112223000001109",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8300000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "f2c6112b-1b8d-4a19-b426-91d4c3d24c6f",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        },
        {
            "carton_number": "00871112224000001106",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8400000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "426e906f-1251-4571-a252-18c6e3157294",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        }
    ],
    "mission_id": "10200051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}

Attach item/items to the specific mission

PUT /serialization-service/mission/put_on
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
mission string Required: Mission ID
to_sscc string Target SSCC code
items list of objects Required: Attached items

Objects items.item has two parameters: item.code and item.to_sscc. item.code for GFP mission type is sscc GS1 code equal to item.to_sscc. item.code for GPK mission type is sgtin GS1 code or SSCC code (carton_number).

Main to_sscc parameter will be used if item.to_sscc does not exist.

Example Request. Collect SGTINs for GPK
{
  "mission": "10100051244",
  "items": [
    {
      "to_sscc": "00871112221000001105",
      "code": "010334890087198421z2(UKhORy!://"
    },
    {
      "to_sscc": "00871112221000001105",
      "code": "010334890087198421zrfFT&SQ1*4!m"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": "00871112221000001105",
            "client": "SELDICO",
            "collected": [
                {
                    "code": "010334890087198421zrfFT&SQ1*4!m",
                    "sgtin": "urn:epc:id:sgtin:3348900.087198.zrfFT&SQ1*4!m"
                },
                {
                    "code": "010334890087198421z2(UKhORy!://",
                    "sgtin": "urn:epc:id:sgtin:3348900.087198.z2(UKhORy!://"
                }
            ],
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8100000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "4dd0f2f1-223d-4865-8f2e-97239099699e",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        },
        {
            "carton_number": "00871112220000001108",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8000000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "043d3c9d-9e69-4ba3-baf1-cdb5703f2a2b",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        }
    ],
    "mission_id": "10100051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request. Collect SSCCs for GPK
{
  "mission": "10200051244",
  "items": [
    {
      "to_sscc": "00871112223000011108",
      "code": "00871112223000001109"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": "00871112223000001109",
            "client": "SELDICO",
            "collected": [
                {
                    "code": "00871112223000001109",
                    "epc_sscc": "urn:epc:id:sscc:7111222.8300000110"
                }
            ],
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8300000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "f2c6112b-1b8d-4a19-b426-91d4c3d24c6f",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        },
        {
            "carton_number": "00871112224000001106",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8400000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "426e906f-1251-4571-a252-18c6e3157294",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        }
    ],
    "mission_id": "10200051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request. Collect SSCCs for GFP
{
  "mission": "10400051244",
  "items": [
    {
      "to_sscc": "00871112227000001107",
      "code": "00871112227000001107"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": null,
            "client": "SELDICO",
            "collected": [
                {
                    "code": "00871112227000001107",
                    "epc_sscc": "urn:epc:id:sscc:7111222.8700000110"
                }
            ],
            "depo": "TKV",
            "epc_carton_number": null,
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8700000110",
            "gtin": "03348900871984",
            "id": "f8a5d45c-9a9f-4a7c-89c9-64985f4d922d",
            "mission_type": "GFP",
            "order_number": "CHP-715211",
            "pallet_number": "00871112227000001107",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10400051244",
            "qty": 5,
            "ts": "2020-02-05T13:38:59Z"
        }
    ],
    "mission_id": "10400051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}

Deattach item/items from the specific mission

PUT /serialization-service/mission/put_off
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
mission string Required: Mission ID
to_sscc string Target SSCC code
items list of objects Required: Attached items

Objects items.item has two parameters: item.code and item.to_sscc. item.code for GFP mission type is sscc GS1 code equal to item.to_sscc. item.code for GPK mission type is sgtin GS1 code or SSCC code (carton_number).

Main to_sscc parameter will be used if item.to_sscc does not exist.

Example Request. Remove SGTINs (GPK)
{
  "mission": "10100051244",
  "items": [
    {
      "to_sscc": "00871112221000001105",
      "code": "010334890087198421z2(UKhORy!://"
    },
    {
      "to_sscc": "00871112221000001105",
      "code": "010334890087198421zrfFT&SQ1*4!m"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": "00871112221000001105",
            "client": "SELDICO",
            "collected": [],
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8100000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "4dd0f2f1-223d-4865-8f2e-97239099699e",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        },
        {
            "carton_number": "00871112220000001108",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8000000110",
            "epc_pallet_number": null,
            "gtin": "03348900871984",
            "id": "043d3c9d-9e69-4ba3-baf1-cdb5703f2a2b",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": null,
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10100051244",
            "qty": 5,
            "ts": "2020-02-05T13:34:41Z"
        }
    ],
    "mission_id": "10100051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request. Remove SSCC (GPK)
{
  "mission": "10200051244",
  "items": [
    {
      "to_sscc": "00871112223000011108",
      "code": "00871112223000001109"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": "00871112223000001109",
            "client": "SELDICO",
            "collected": [],
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8300000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "f2c6112b-1b8d-4a19-b426-91d4c3d24c6f",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        },
        {
            "carton_number": "00871112224000001106",
            "client": "SELDICO",
            "depo": "TKV",
            "epc_carton_number": "urn:epc:id:sscc:7111222.8400000110",
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8300001110",
            "gtin": "03348900871984",
            "id": "426e906f-1251-4571-a252-18c6e3157294",
            "mission_type": "GPK",
            "order_number": "CHP-715211",
            "pallet_number": "00871112223000011108",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10200051244",
            "qty": 5,
            "ts": "2020-02-05T13:37:19Z"
        }
    ],
    "mission_id": "10200051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}
Example Request. Remove SSCC (GFP)
{
  "mission": "10400051244",
  "items": [
    {
      "to_sscc": "00871112227000001107",
      "code": "00871112227000001107"
    }
  ]
}
Example Response
{
    "list": [
        {
            "carton_number": null,
            "client": "SELDICO",
            "collected": [],
            "depo": "TKV",
            "epc_carton_number": null,
            "epc_pallet_number": "urn:epc:id:sscc:7111222.8700000110",
            "gtin": "03348900871984",
            "id": "f8a5d45c-9a9f-4a7c-89c9-64985f4d922d",
            "mission_type": "GFP",
            "order_number": "CHP-715211",
            "pallet_number": "00871112227000001107",
            "participant": "urn:authenticateit:participant:804355519238230",
            "preparation_number": "10400051244",
            "qty": 5,
            "ts": "2020-02-05T13:38:59Z"
        }
    ],
    "mission_id": "10400051244",
    "owner": "urn:authenticateit:participant:804355519238230"
}

Solea items handling

PUT /serialization-service/mission/solea
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
items list of objects Required: Items to be handled
Example Request
{
  "items": [
    {
      "tour_code": "11111128742",
      "container_handling_code": "241111111136465822",
      "sku": "P083382",
      "trade_unit": "03",
      "sscc_client": "00577341703831364419"
    },
    {
      "tour_code": "11111128742",
      "container_handling_code": "241111111136465822",
      "sku": "P083382",
      "trade_unit": "03",
      "sscc_client": "00577341703838605614"
    },
    {
      "tour_code": "11111118742",
      "container_handling_code": "00241111111126465825",
      "sku": "P083382",
      "trade_unit": "00",
      "code": "0103274872387942214KRVDVZQ5BCAO"
    },
    {
      "tour_code": "11111118742",
      "container_handling_code": "00241111111126465825",
      "sku": "P083382",
      "trade_unit": "00",
      "code": "0103274872387942218N49IWH2S854W"
    },
    {
      "tour_code": "11111118742",
      "container_handling_code": "00241111111126465825",
      "sku": "P083382",
      "trade_unit": "00",
      "code": "010327487238794221E7SHA62IZATQ8"
    }
  ]
}
Example Response
{
    "missed": [
        "010327487238794221E7SHA62IZATQ8"
    ],
    "stored": [
        "0103274872387942214KRVDVZQ5BCAO",
        "0103274872387942218N49IWH2S854W",
        "00577341703831364419",
        "00577341703838605614"
    ]
}

Validate mission according SLI/SL1

POST /serialization-service/mission/validate
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
preparation_number string Required: Mission ID
type string Required: sli or sl1
withdrawalType string Withdrawal reason
issuer string SLI/SL1 issuer
consigneeCode string Reassignment participant ID
containers object Required: sli or sl1
containers.qty integer Required: Quantity in container
containers.cartonId string Required: container id (SSCC code)
containers.hdId string Required: Pallet id (SSCC code)
containers.gtin string Required: Gtin

issuer is optional field. Is issuer is empty, list of childs participants will be loaded from current_participant according ticket

Example Request
{
  "preparation_number": "999888111",
  "type": "sli",
  "consigneeCode":"521",
  "owner_code": "DIR",
  "depo": "TKV",
  "order_number": "CHK-999888111",
  "containers": [
    {
      "qty": 6,
      "sku": "F976014001",
      "gtin": "03348900487451",
      "cartonId": "999888111100001105"
    },
    {
      "qty": 5,
      "sku": "F002760017",
      "gtin": "03348900387881",
      "cartonId": "999888111100001105"
    },
    {
      "qty": 6,
      "sku": "F430021005",
      "gtin": "03348900928381",
      "hdId": "999888111200001104"
    }
  ]
}
Example Response
{
    "id": "39b86bf1-edcb-42a5-b80f-e776457ea225",
    "owner": {
        "external_id": "521",
        "id": "urn:authenticateit:participant:571534011284642",
        "inn": "7729683125",
        "name": "ООО \"Семь кистей\"",
        "sscc_document": "0",
        "transfer_type": "1",
        "withdrawal_type": ""
    },
    "tree": {
        "00999888111100001105": [
            {
                "code": "010334890038788121?:J-RTyQmzW;F",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.?:J-RTyQmzW;F",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121_'eUaeoGrR1k!",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788._'eUaeoGrR1k!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121a7OYT7qgzxw1k",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.a7OYT7qgzxw1k",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121g8j?&h;*<P-wk",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.g8j?&h;*<P-wk",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121wwuK_1cYl11k!",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.wwuK_1cYl11k!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121\"KShI&%vCde85",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.\"KShI&%vCde85",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "0103348900487451214!->I;QQ*x3dV",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.4!->I;QQ*x3dV",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121TsAhs9bPaml;F",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.TsAhs9bPaml;F",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121XE41Oi-gfMR1k",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.XE41Oi-gfMR1k",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121kj0Aw+URC3dV!",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.kj0Aw+URC3dV!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121q7/b\"Xw,=sc>V",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.q7/b\"Xw,=sc>V",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            }
        ],
        "00999888111200001104": {
            "00577341703831309557": [
                {
                    "code": "010334890092838121,WC=fqZbD7b&5",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.,WC=fqZbD7b&5",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                },
                {
                    "code": "0103348900928381215g!iQDPzyhbaF",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.5g!iQDPzyhbaF",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                },
                {
                    "code": "0103348900928381216<J875WjF+0OV",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.6<J875WjF+0OV",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                },
                {
                    "code": "010334890092838121baOgvb?sVvi+F",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.baOgvb?sVvi+F",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                },
                {
                    "code": "010334890092838121S6h>4=dIQo6tV",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.S6h>4=dIQo6tV",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                },
                {
                    "code": "010334890092838121wIuy?IcaOG_.V",
                    "gtin": "03348900928381",
                    "id": "urn:epc:id:sgtin:3348900.092838.wIuy?IcaOG_.V",
                    "sscc": "urn:epc:id:sscc:7734170383.5130955"
                }
            ]
        }
    }
}
Example Request
{
  "preparation_number": "999888111",
  "type": "sli",
  "consigneeCode":"521",
  "owner_code": "DIR",
  "depo": "TKV",
  "order_number": "CHK-999888111",
  "containers": [
    {
      "qty": 6,
      "sku": "F976014001",
      "gtin": "03348900487451",
      "cartonId": "999888111100001105"
    },
    {
      "qty": 5,
      "sku": "F002760017",
      "gtin": "03348900387881",
      "cartonId": "999888111100001105"
    },
    {
      "qty": 6,
      "sku": "F430021005",
      "gtin": "03348900928381",
      "hdId": "999888111200001104"
    }
  ]
}
Example Response
{
    "id": "f12f1461-78eb-4812-bd02-f587b7c6e2b9",
    "owner": {
        "external_id": "521",
        "id": "urn:authenticateit:participant:571534011284642",
        "inn": "7729683125",
        "name": "ООО \"Семь кистей\"",
        "sscc_document": "1",
        "transfer_type": "1",
        "withdrawal_type": ""
    },
    "tree": {
        "00577341703836841656": [
            {
                "code": "010334890092838121,WC=fqZbD7b&5",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.,WC=fqZbD7b&5",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "0103348900928381215g!iQDPzyhbaF",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.5g!iQDPzyhbaF",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "0103348900928381216<J875WjF+0OV",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.6<J875WjF+0OV",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "010334890092838121baOgvb?sVvi+F",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.baOgvb?sVvi+F",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "010334890092838121S6h>4=dIQo6tV",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.S6h>4=dIQo6tV",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "010334890092838121wIuy?IcaOG_.V",
                "gtin": "03348900928381",
                "id": "urn:epc:id:sgtin:3348900.092838.wIuy?IcaOG_.V",
                "sscc": "urn:epc:id:sscc:7734170383.5130955"
            },
            {
                "code": "010334890038788121?:J-RTyQmzW;F",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.?:J-RTyQmzW;F",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121_'eUaeoGrR1k!",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788._'eUaeoGrR1k!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121a7OYT7qgzxw1k",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.a7OYT7qgzxw1k",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121g8j?&h;*<P-wk",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.g8j?&h;*<P-wk",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890038788121wwuK_1cYl11k!",
                "gtin": "03348900387881",
                "id": "urn:epc:id:sgtin:3348900.038788.wwuK_1cYl11k!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121\"KShI&%vCde85",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.\"KShI&%vCde85",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "0103348900487451214!->I;QQ*x3dV",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.4!->I;QQ*x3dV",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121TsAhs9bPaml;F",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.TsAhs9bPaml;F",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121XE41Oi-gfMR1k",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.XE41Oi-gfMR1k",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121kj0Aw+URC3dV!",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.kj0Aw+URC3dV!",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            },
            {
                "code": "010334890048745121q7/b\"Xw,=sc>V",
                "gtin": "03348900487451",
                "id": "urn:epc:id:sgtin:3348900.048745.q7/b\"Xw,=sc>V",
                "sscc": "urn:epc:id:sscc:9988811110.9000110"
            }
        ]
    }
}

Continue reassignment (withdrawal)

POST /serialization-service/mission/validate/reassignment
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
id string Required: Reassignment ID
Example Request
{
  "id": "f12f1461-78eb-4812-bd02-f587b7c6e2b9"
}

Merge containers

POST /serialization-service/packaging/container/merge
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc_from string or list Required: Source SSCC code (or list)
sscc_to string Required: Destination SSCC code
Example Request
{
  "sscc_from": "urn:epc:id:sscc:7734170383.0001090",
  "sscc_to": "urn:epc:id:sscc:7734170383.0001091"
}
Example Request
{
  "sscc_from": ["urn:epc:id:sscc:7734170383.0001090"],
  "sscc_to": "urn:epc:id:sscc:7734170383.0001091"
}

Disaggragate container

POST /serialization-service/packaging/container/disaggragate
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc string Required: SSCC code
Example Request
{
  "sscc": "urn:epc:id:sscc:7734170383.0001091"
}

Pack items to container

PUT /serialization-service/packaging/items/pack
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc string Required: SSCC code
items string Required: List of SGTIN's or list of SSCC's
Example Request
{
  "sscc": "urn:epc:id:sscc:7734170383.0001092",
  "items": [
      "urn:epc:id:sgtin:3348900.087198.!\":Oov+ffaCS)",
      "urn:epc:id:sgtin:3348900.087198.!!pDlI5LU3K9+"
  ]
}
Example Request
{
  "sscc": "urn:epc:id:sscc:7734170383.0001093",
  "items": [
      "urn:epc:id:sscc:7734170383.0001091",
      "urn:epc:id:sscc:7734170383.0001092"
  ]
}

Unpack items from container

PUT /serialization-service/packaging/items/unpack
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc string Required: SSCC code
items string Required: List of SGTIN's or list of SSCC's
Example Request
{
  "sscc": "urn:epc:id:sscc:7734170383.0001092",
  "items": [
      "urn:epc:id:sgtin:3348900.087198.!\":Oov+ffaCS)",
      "urn:epc:id:sgtin:3348900.087198.!!pDlI5LU3K9+"
  ]
}
Example Request
{
  "sscc": "urn:epc:id:sscc:7734170383.0001093",
  "items": [
      "urn:epc:id:sscc:7734170383.0001091",
      "urn:epc:id:sscc:7734170383.0001092"
  ]
}

Circulation

Remove crypto-tails

POST /serialization-service/circulation/cryptotails/delete
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc string Required: SSCC code
invoiceNumber string Required: Invoice Number
invoiceDate string Required: Invoice Date
gtin string Required: Base GTIN
codes list List of SGTINs objects
declaration_number string Optional. Will be converted to sources
declaration_date string Optional. Will be converted to sources
customs_code string Optional. Will be converted to sources
tnved_code string Optional. Will be converted to sources
certificate_document string Optional. Will be converted to sources
certificate_document_number string Optional. Will be converted to sources
certificate_document_date string Optional. Will be converted to sources

Parameter sscc or group of invoiceNumber, invoiceDate, gtin are required.
If the list of codes (codes) has not been set then all codes of sscc will be applied.

Example Request
{
  "sscc": "00577040987327986277",
  "invoiceNumber": "invoiceNumberTestCert",
  "invoiceDate": "2020-05-30",
  "gtin": "03614228074223",
  "declaration_number": "test_declar_num",
  "declaration_date": "test_declar_date",
  "customs_code": "cus_code",
  "tnved_code": "3303009000",
  "certificate_document": "CONFORMITY_DECLARATION",
  "certificate_document_date": "23.02.2020",
  "certificate_document_number": "ЕАЭСRUД-FR.АC19.В.05411"
}
Example Request
{
  "sscc": "00577040987322576244",
  "codes": [
    {
      "code": "010361422807422321_WgwfSmClB<Ko",
      "id": "urn:epc:id:sgtin:3614228.007422._WgwfSmClB<Ko"
    },
    {
      "code": "010361422807422321_X(ip30:vYSVU",
      "id": "urn:epc:id:sgtin:3614228.007422._X(ip30:vYSVU"
    },
    {
      "code": "010361422807422321_Y>',=FKrmQ(B",
      "id": "urn:epc:id:sgtin:3614228.007422._Y>',=FKrmQ(B"
    }
  ],
  "gtin": "03614228074223",
  "declaration_number": "test_declar_num",
  "declaration_date": "test_declar_date",
  "customs_code": "cus_code",
  "tnved_code": "3303009000",
  "certificate_document": "CONFORMITY_DECLARATION",
  "certificate_document_date": "23.02.2020",
  "certificate_document_number": "ЕАЭСRUД-FR.АC19.В.05411"
}

Get initial SSCC

POST /serialization-service/circulation/sscc/get
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
invoiceNumber string Invoice Number
invoiceDate string Invoice Date
gtin string Base GTIN
list array Search list
Example Request
{
  "list": [
    {
      "invoiceNumber": "CHK-11223402", 
      "gtin": "03614228074223" 
    }
  ]
}
Example Response
[
    {
        "codes": [
            {
                "code": "010361422807422321!)W5A_-,NpGKZ",
                "id": "urn:epc:id:sgtin:3614228.007422.!)W5A_-,NpGKZ"
            },
            {
                "code": "010361422807422321!;fWMsXgkqA*E",
                "id": "urn:epc:id:sgtin:3614228.007422.!;fWMsXgkqA*E"
            },
            {
                "code": "010361422807422321!EsuN5t4wq:Po",
                "id": "urn:epc:id:sgtin:3614228.007422.!EsuN5t4wq:Po"
            }
        ],
        "gtin": "03614228074223",
        "invoiceDate": "2020-07-11",
        "invoiceNumber": "CHK-11223402",
        "qty": 3,
        "reflexNumber": null,
        "sscc": "00577040987322576244"
    }
]
Example Request
{
  "invoiceNumber": "CHK-11223402", 
  "gtin": "03614228074223",
  "invoiceDate": "2020-07-11"
}
Example Response
{
    "codes": [
        {
            "code": "010361422807422321!)W5A_-,NpGKZ",
            "id": "urn:epc:id:sgtin:3614228.007422.!)W5A_-,NpGKZ"
        },
        {
            "code": "010361422807422321!;fWMsXgkqA*E",
            "id": "urn:epc:id:sgtin:3614228.007422.!;fWMsXgkqA*E"
        },
        {
            "code": "010361422807422321!EsuN5t4wq:Po",
            "id": "urn:epc:id:sgtin:3614228.007422.!EsuN5t4wq:Po"
        }
    ],
    "qty": 3,
    "reflexNumber": null,
    "sscc": "00577040987322576244"
}

Remark. Start process.

POST /serialization-service/remark
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
code string Required: Sgtin code
Example Request
{
 "code": "010334647010957521uKH0NMNOqmo7c"
}
Example Response
{
    "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark"
}

Remark. Get status

POST /serialization-service/remark/status/get
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
id string Required: Remark Id
Example Request
{
 "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark"
}
Example Response. Pending
{
  "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark",
   "certificate_document": "CONFORMITY_CERT",
   "certificate_document_date": "2018-09-17T21:00:00.000Z",
   "certificate_document_number": "certificateDocumentNumber",
   "code": "010334647010957521uKH0NMNOqmo7c",
   "gtin": "03346470109575",
   "inn": "7734170383",
   "participant": "urn:authenticateit:participant:804355519238230",
   "sgtin": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c",
   "st_ts_wr": "2020-01-29T14:43:09Z",
   "status": "pending",
   "user": "urn:authenticateit:user:email:system@authenticateit.com"
}
Example Response. Success
{
    "certificate_document": "CONFORMITY_CERT",
    "certificate_document_date": "2018-09-17T21:00:00.000Z",
    "certificate_document_number": "certificateDocumentNumber",
    "code": "010334647010957521uKH0NMNOqmo7c",
    "gtin": "03346470109575",
    "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark",
    "inn": "7734170383",
    "new_code": "010334647010957521x5eiSsYJ0yCJX\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM=",
    "new_sgtin": "urn:epc:id:sgtin:3346470.010957.x5eiSsYJ0yCJX",
    "participant": "urn:authenticateit:participant:804355519238230",
    "sgtin": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c",
    "status": "success",
    "user": "urn:authenticateit:user:email:system@authenticateit.com"
}
Example Response. Failure
{
  "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark",
   "certificate_document": "CONFORMITY_CERT",
   "certificate_document_date": "2018-09-17T21:00:00.000Z",
   "certificate_document_number": "certificateDocumentNumber",
   "code": "010334647010957521uKH0NMNOqmo7c",
   "gtin": "03346470109575",
   "inn": "7734170383",
   "participant": "urn:authenticateit:participant:804355519238230",
   "sgtin": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c",
   "st_ts_wr": "2020-01-29T14:43:09Z",
   "status": "failure",
   "user": "urn:authenticateit:user:email:system@authenticateit.com"
}

Remark. Mark code as used

POST /serialization-service/remark/used
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
id string Required: Remark Id
Example Request
{
 "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark"
}
Example Response
{
    "certificate_document": "CONFORMITY_CERT",
    "certificate_document_date": "2018-09-17T21:00:00.000Z",
    "certificate_document_number": "certificateDocumentNumber",
    "code": "010334647010957521uKH0NMNOqmo7c",
    "gtin": "03346470109575",
    "id": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c@code_remark",
    "inn": "7734170383",
    "new_code": "010334647010957521x5eiSsYJ0yCJX",
    "new_sgtin": "urn:epc:id:sgtin:3346470.010957.x5eiSsYJ0yCJX",
    "participant": "urn:authenticateit:participant:804355519238230",
    "sgtin": "urn:epc:id:sgtin:3346470.010957.uKH0NMNOqmo7c",
    "status": "success",
    "used": true,
    "user": "urn:authenticateit:user:email:system@authenticateit.com"
}

Remark. Change status

POST /serialization-service/remark/status/set
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
id string Required: Remark Id
status string Required: success or failure
code string Required: SGTIN code if status =success
Example Request
{
 "id": "urn:epc:id:sgtin:3346470.010957.bVYVDka8KDnkw@code_remark",
 "status": "success",
 "code": "010334647010957521uKH0NMNOqmo7c\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM="
}

Return orders

Create return order

POST /serialization-service/circulation/returns/order
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
invoiceNumber string Required: Invoice Number
invoiceDate string Invoice Number
deliveryNumber string Delivery Number
list list Required: Return composition
issuer string Return issuer
Example Request
{
  "invoiceNumber": "TestNumber",
  "list": [
    {
      "gtin": "03274872369436",
      "qty": "5",
      "sku": "P041283"
    },
    {
      "gtin": "03348900871984",
      "qty": "5",
      "sku": "F032622889"
    }
  ]
}
Example Response
{
    "invoiceNumber": "TestNumber",
    "list": [
        {
            "gtin": "03274872369436",
            "qty": 5,
            "sku": "P041283"
        },
        {
            "gtin": "03348900871984",
            "qty": 5,
            "sku": "F032622889"
        }
    ],
    "owner": "urn:authenticateit:participant:804355519238230"
}

Read return order state

POST /serialization-service/circulation/returns/order/get
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
invoiceNumber string Required: Invoice Number
Example Request
{
  "invoiceNumber": "TestNumber"
}
Example Response
{
    "invoiceNumber": "TestNumber",
    "list": [
        {
            "gtin": "03274872369436",
            "qty": 5,
            "sku": "P041283"
        },
        {
            "gtin": "03348900871984",
            "qty": 5,
            "sku": "F032622889"
        }
    ],
    "owner": "urn:authenticateit:participant:804355519238230"
}

Assembly of SGTINs

PUT /serialization-service/circulation/returns/order
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
invoiceNumber string Required: Invoice Number
list [string] Required: List of codes
Example Request
{
  "invoiceNumber": "TestNumber",
  "list": [
    "010334890087198421&_ZLFOAU=LY3/\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM=",
    "010334890087198421<:/pCsZFTSC3P\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM="
  ]
}
Example Response
{
    "invoiceNumber": "TestNumber",
    "list": [
        {
            "gtin": "03274872369436",
            "qty": 5,
            "sku": "P041283"
        },
        {
            "collected": [
                {
                    "code": "010334890087198421&_ZLFOAU=LY3/\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM=",
                    "id": "urn:epc:id:sgtin:3348900.087198.&_ZLFOAU=LY3/"
                },
                {
                    "code": "010334890087198421<:/pCsZFTSC3P\u001d91EE05\u001d92gF3jaA99RKBLOViAe1akW9nMYKQlgV/NKm8nVTFAcJM=",
                    "id": "urn:epc:id:sgtin:3348900.087198.<:/pCsZFTSC3P"
                }
            ],
            "gtin": "03348900871984",
            "qty": 5,
            "sku": "F032622889"
        }
    ],
    "owner": "urn:authenticateit:participant:804355519238230"
}

Mark return order application processing

POST /serialization-service/circulation/returns/order/mark
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
id string Required: Request Id
status string success (default) or failure
Example Request
{
  "id": "dc82783c-681a-48e9-bc88-e43a59243726"
}

Inventory

Inventory the state of container

POST /serialization-service/packaging/container/inventory
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
sscc string Required: Container code
items list Required: List of coupled item codes
Example Request
{
  "sscc": "00001191000013055040",
  "items": [
    "010334890087198421>K3P9+qfui5Y5\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4=",
    "010334890087198421g'H:S8QfQ8*gk\u001d91EE05\u001d923LQZZHyjoOQ1wd2TmwXlbgWrs/ei3owacH16mF3Neu4="
  ]
}

Read inventory reports

POST /serialization-service/packaging/container/inventory/get
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
skip string Like offset in sql
take string Like limit in sql
order string RSQL order
type string Type of request: data or count
query string RSQL query
op string Condition: OR/AND

Field list for filters:
"carton" - carton EPC ID
"carton_gs1" - carton GS1 ID
"pallet" - pallet EPC ID
"pallet_gs1" - pallet GS1 ID
"doc_id" - report doc ID
"gtin" - GTIN value
"sku" - SKU value
"ts" - inventory datetime
"id" - row ID
"user_first_name" - user's first name
"user_id" - user ID
"user_last_name" - user's last name
"not_valid" - quantity of not valid scanned elements
"presented" - quantity of elements in T&T
"scanned" - quantity of total scanned elements
"valid" - quantity of valid elements

Example Request
{
  "order": "ts-desc",
  "query":"",
  "op":"AND",
  "skip": "1",
  "take": "2"
}
Example Request
{
 "order": "ts-desc",
 "query":"user_last_name=like=|Admin|",
 "op":"AND",
 "skip": "1",
 "take": "2"
}
Example Response
{
    "count": 8,
    "data": [
        {
            "carton": "urn:epc:id:sscc:7734170383.5325689",
            "carton_gs1": "00577341703833256897",
            "doc_id": "urn:authenticateit:participant:804355519238230@inventory_report@bd0bb3ca-014c-4fc5-93b5-bbfed38650b4",
            "gtin": "00334647023406",
            "id": "urn:authenticateit:participant:804355519238230@inventory_report@bd0bb3ca-014c-4fc5-93b5-bbfed38650b4@2020-03-10T11:13:36Z@518f0a8a-483f-4add-99e2-e5751574ce15",
            "not_valid": 0,
            "pallet": null,
            "pallet_gs1": null,
            "participant_id": "urn:authenticateit:participant:804355519238230",
            "presented": 15,
            "scanned": 0,
            "sku": "\"              02340",
            "ts": "2020-03-10T11:13:36Z",
            "user_first_name": "System",
            "user_id": "urn:authenticateit:user:email:system@authenticateit.com",
            "user_last_name": "Administrator",
            "valid": 0
        },
        {
            "carton": "urn:epc:id:sscc:7734170383.5325689",
            "carton_gs1": "00577341703833256897",
            "doc_id": "urn:authenticateit:participant:804355519238230@inventory_report@ac769822-a794-4876-9cdc-1277332d0cb5",
            "gtin": "00334647023406",
            "id": "urn:authenticateit:participant:804355519238230@inventory_report@ac769822-a794-4876-9cdc-1277332d0cb5@2020-03-10T11:12:12Z@e42a5132-fe94-4d5a-9de5-15c1db1fd6f8",
            "not_valid": 15,
            "pallet": "urn:epc:id:sscc:7734170.5383894911",
            "pallet_gs1": "00577341703838949114",
            "participant_id": "urn:authenticateit:participant:804355519238230",
            "presented": 15,
            "scanned": 0,
            "sku": "\"              02340",
            "ts": "2020-03-10T11:12:12Z",
            "user_first_name": "System",
            "user_id": "urn:authenticateit:user:email:system@authenticateit.com",
            "user_last_name": "Administrator",
            "valid": 0
        }
    ]
}

Certificates

Set certificate

Method allows to set certificate data according invoice_number and gtin

POST /serialization-service/certificate/set
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
gtin string Required: Gtin code
invoice_number string Required: Emission invoice
certificate_document string Required: Document type
certificate_document_date string Required: Document date
certificate_document_number string Required: Document number
Example Request
{
  "gtin": "00000000000000",
  "invoice_number": "TestInvoiceNumber",
  "certificate_document": "Test type",
  "certificate_document_date": "Test date",
  "certificate_document_number": "Test number"
}
Example Response
{
    "certificate_document": "Test type",
    "certificate_document_date": "Test date",
    "certificate_document_number": "Test number",
    "gtin": "00000000000000",
    "id": "00000000000000@urn:authenticateit:participant:804355519238230@TestInvoiceNumber@certificate",
    "invoice_number": "TestInvoiceNumber",
    "issuer": "urn:authenticateit:participant:804355519238230",
    "ts": "2020-05-25T12:32:35Z",
    "type": "gtin_certificate",
    "user": "urn:authenticateit:user:email:system@authenticateit.com"
}

Get certificate

POST /serialization-service/certificate/get
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
gtin string Required: Gtin code
invoice_number string Required: Emission invoice
Example Request
{
  "gtin": "00000000000000",
  "invoice_number": "TestInvoiceNumber"
}
Example Response
{
    "certificate_document": "Test type",
    "certificate_document_date": "Test date",
    "certificate_document_number": "Test number",
    "gtin": "00000000000000",
    "id": "00000000000000@urn:authenticateit:participant:804355519238230@TestInvoiceNumber@certificate",
    "invoice_number": "TestInvoiceNumber",
    "issuer": "urn:authenticateit:participant:804355519238230",
    "ts": "2020-05-25T12:32:35Z",
    "type": "gtin_certificate",
    "user": "urn:authenticateit:user:email:system@authenticateit.com"
}

Custom declaration

Set declaration data

Method allows to set declaration data according invoice_number and gtin

POST /serialization-service/gtd/set
Parameters
Name Type Description
authenticateit_identity_ticket header Required: Session's ticket
gtin string Required: Gtin code
invoice_number string Required: Emission invoice
customs_code string Required: Custom code
declaration_date string Required: Document date
declaration_number string Required: Document number
Example Request
{
  "gtin": "03614228074223",
  "invoice_number": "TestInvoiceNumber",
  "customs_code": "40003",
  "declaration_date": "2020-06-12",
  "declaration_number": "123456-9232"
}
Example Response
{
    "customs_code": "40003",
    "declaration_date": "2020-06-12",
    "declaration_number": "123456-9232",
    "gtin": "03614228074223",
    "id": "03614228074223@urn:authenticateit:participant:804355519238230@TestInvoiceNumber@gtd",
    "invoice_number": "TestInvoiceNumber",
    "issuer": "urn:authenticateit:participant:804355519238230",
    "ts": "2020-06-24T14:31:12Z",
    "type": "gtin_gtd",
    "user": "urn:authenticateit:user:email:system@authenticateit.com"
}

Track & Trace Log

Read Log

Retrieve log of Track & Trace operations. Responds with the list of log entries in data field. Log entries may be filtered by providing parameters in the request JSON body. The following parameters may be used for filtering:

  • after_time, before_time — fetch only entries having timestamp greater than after_time and less than before_time.
  • invoice_number — fetch only entries having the specified invoice number.
  • sscc — fetch only entries where container SSCC equals to the specified one.
  • operation — fetch only entries of the specified type (pack_products, pack_containers, reassignment or unpack).

Number of returned entries may be limited with limit parameter (50 by default).

The returned entries are sorted by timestamp from most recent to least recent. Sort order may be changed with sort_order parameter (asc or desc).

POST /serialization-service/track_trace/get_log
Parameters
Name Type Description
authenticateit_identity_ticket header Session ticket
Example Request
{
  "after_time": "2020-02-01T01:15:00Z",
  "operation": "pack_products",
  "sort_order": "asc"
}
Example Response
{
  "after_time": "2020-02-01T01:15:00Z",
  "operation": "pack_products",
  "limit": 50,
  "sort_order": "asc",
  "data": [
    {
      "invoice_number": "SAP-256004",
      "item_number": "L125896",
      "operation": "pack_products",
      "serial_number": "%156487';4566",
      "sscc": "0123456789456321478",
      "timestamp": "2020-02-05T09:18:00Z",
      "user_id": "urn:authenticateit:user:email:NLAR@shping.com"
    },
    {
      "invoice_number": "SAP-256004",
      "item_number": "L125897",
      "operation": "pack_products",
      "serial_number": "%156487';4567",
      "sscc": "0123456789456321478",
      "timestamp": "2020-02-05T09:23:00Z",
      "user_id": "urn:authenticateit:user:email:NLAR@shping.com"
    },
    {
      "invoice_number": "SAP-256004",
      "item_number": "L125898",
      "operation": "pack_products",
      "serial_number": "%156487';4568",
      "sscc": "0123456789456321478",
      "timestamp": "2020-02-05T09:30:00Z",
      "user_id": "urn:authenticateit:user:email:NLAR@shping.com"
    }
  ]
}

results matching ""

    No results matching ""