OriginsNext utiliza un formato de identificador consistente en todo el sistema: [source].[id]. El source es el esquema de identificación (un estándar reconocido, como GLN o GTIN) y el id es el valor en sí. Los dos se unen con un punto. Por ejemplo, GLN.WAREHOUSE-A es una ubicación identificada mediante el esquema Global Location Number con el valor WAREHOUSE-A.
El formato [source].[id]
El prefijo source indica a OriginsNext (y a sus socios comerciales) a qué esquema de identificación pertenece el valor, de modo que la misma entidad pueda reconocerse de forma consistente entre organizaciones y sistemas. Utilizará este formato en cualquier lugar donde haga referencia a una entidad: en los registros, en cargas de CSV y a través de la API.
Source: el esquema, por ejemplo GLN (Global Location Number), GTIN (Global Trade Item Number), SGTIN (Serialised Global Trade Item Number), SSCC (Serial Shipping Container Code), ABN (Australian Business Number) o CNPJ (número de registro empresarial brasileño).
Id: el valor del identificador bajo ese esquema.
En una carga de CSV, si necesita incluir más de un identificador en una sola celda, sepárelos con el carácter de barra vertical ( | ).
IDs para las entidades principales
El mismo formato se aplica a todas las entidades. Los esquemas y ejemplos habituales son:
Entidad | Esquema de ID típico | Ejemplo |
Participante (Organización) | Un identificador comercial, como GLN, ABN o CNPJ. | GLN.PRODUCER-1 |
Ubicación | GLN (Global Location Number). | GLN.WAREHOUSE-A |
Producto | SGTIN (Serialised Global Trade Item Number). | SGTIN.PROD-001 |
Plantilla de Producto (SKU) | GTIN, SKU o UPC. | GTIN.BANANA-CLASS-A |
Unidad logística (pallet o contenedor) | SSCC (Serial Shipping Container Code). | SSCC.PALLET-001 |
Nota: La misma Organización puede identificarse con diferentes esquemas en distintos contextos (por ejemplo, un GLN en un país y un ABN o CNPJ en otro). Utilice el esquema que corresponda al identificador que posee.
IDs con caracteres especiales
Algunos identificadores se escriben habitualmente con signos de puntuación. Por ejemplo, un CNPJ brasileño suele mostrarse como 12.345.678/0001-95. Antes de utilizar cualquier identificador en OriginsNext, elimine todos los caracteres especiales (puntos, barras, guiones y espacios) para que queden solo letras y números, y luego añada el prefijo del esquema. Así, 12.345.678/0001-95 se convierte en CNPJ.12345678000195.
Importante: Elimine siempre la puntuación y los espacios de un identificador, conservando solo los caracteres alfanuméricos, y utilice ese mismo valor limpio en todas partes. Los IDs consistentes y sin puntuación son los que permiten a OriginsNext reconocer al mismo Participante, Ubicación o Producto entre cargas, integraciones y datos de otros participantes, y evitan duplicados.