O OriginsNext utiliza um formato de identificador consistente em todo o sistema: [source].[id]. O source é o esquema de identificação (um padrão reconhecido, como GLN ou GTIN) e o id é o próprio valor. Os dois são separados por um ponto. Por exemplo, GLN.WAREHOUSE-A é uma localização identificada pelo esquema Global Location Number com o valor WAREHOUSE-A.
O formato [source].[id]
O prefixo source informa ao OriginsNext (e aos seus parceiros comerciais) a qual esquema de identificação o valor pertence, para que a mesma entidade possa ser reconhecida de forma consistente entre organizações e sistemas. Você utilizará esse formato em qualquer lugar que referencie uma entidade: nos registros, em uploads de CSV e pela API.
Source: o esquema, por exemplo GLN (Global Location Number), GTIN (Global Trade Item Number), SGTIN (Serialised Global Trade Item Number), SSCC (Serial Shipping Container Code), ABN (Australian Business Number) ou CNPJ (número de registro de empresa brasileiro).
Id: o valor do identificador nesse esquema.
Em um upload de CSV, se precisar incluir mais de um identificador em uma única célula, separe-os com o caractere de barra vertical ( | ).
IDs para as principais entidades
O mesmo formato se aplica a todas as entidades. Os esquemas e exemplos mais comuns são:
Entidade | Esquema de ID típico | Exemplo |
Participante (Organização) | Um identificador comercial, como GLN, ABN ou CNPJ. | GLN.PRODUCER-1 |
Local | GLN (Global Location Number). | GLN.WAREHOUSE-A |
Produto | SGTIN (Serialised Global Trade Item Number). | SGTIN.PROD-001 |
Template de Produto (SKU) | GTIN, SKU ou UPC. | GTIN.BANANA-CLASS-A |
Unidade logística (palete ou contêiner) | SSCC (Serial Shipping Container Code). | SSCC.PALLET-001 |
Nota: A mesma Organização pode ser identificada por esquemas diferentes em contextos distintos (por exemplo, um GLN em um país e um ABN ou CNPJ em outro). Utilize o esquema que corresponde ao identificador que você possui.
IDs com caracteres especiais
Alguns identificadores são normalmente escritos com pontuação. Por exemplo, um CNPJ brasileiro costuma ser exibido como 12.345.678/0001-95. Antes de utilizar qualquer identificador no OriginsNext, remova todos os caracteres especiais (pontos, barras, hifens e espaços), mantendo apenas letras e números, e então adicione o prefixo do esquema. Assim, 12.345.678/0001-95 se torna CNPJ.12345678000195.
Importante: Sempre remova a pontuação e os espaços de um identificador, mantendo apenas os caracteres alfanuméricos, e utilize esse mesmo valor limpo em todos os lugares. IDs consistentes e sem pontuação são o que permite ao OriginsNext identificar o mesmo Participante, Local ou Produto entre uploads, integrações e dados de outros participantes, evitando duplicatas.