Verified by GS1

API tjenesten gir mulighet for oppslag mot GS1 Registry Platform. Oppslag på GTIN kode og Lisenseier er tilgjengelig i APIet per i dag. APIet vil bli forløpende utvidet til også å gjelde GLN og andre GS1 identifikatorer.

Link til Swagger API mot GS1 Registry Platform

Eksempel

• Eksempel: Oppslag på GTIN

  Endepunkt:

  

  Beskrivelse

  Dette endepunktet gir deg mulighet til å gjøre oppslag på et GTIN. APIet returnerer informasjon avhengig av hva som er lastet opp i det globale registeret. Dersom det ikke er lastet opp informasjon om selve produktet, vil APIet returnere informasjon om eier av lisensen. Input skal ha 14 siffer. Et GTIN-13 skal da ha 0 foran.

  Request – eksempel

  {

    «gtins»: [«07090064260062»]

  }

  Response

  [

    {

      «licenseeName»: «NORDIC PRODUCT AS»,

      «gtin»: «07090064260062»,

      «gs1Licence»: {

        «licenceType»: «GCP»,

        «licenceKey»: «709006426»,

        «licenseeName»: «NORDIC PRODUCT AS»,

        «licensingMO»: {},

        «contactPoint»: [],

        «address»: {

          «countryCode»: «NO»,

          «streetAddress»: {

            «language»: «und»,

            «value»: «Mørtelverksbakken 17»

          },

          «addressLocality»: {

            «language»: «und»,

            «value»: «OSLO»

          },

          «postalCode»: «0580»

        },

        «dateCreated»: «2023-11-06T06:45:36.4186684Z»,

        «dateUpdated»: «2023-11-06T06:45:36.4186684Z»

      },

      «isComplete»: true,

      «gpcCategoryCode»: «10000467»,

      «brandName»: [

        {

          «language»: «no»,

          «value»: «Uniiq»

        }

      ],

      «productDescription»: [

        {

          «language»: «no»,

          «value»: «Uniiq Elektrolytter – Pasjonsfrukt 30 Stk»

        }

      ],

      «productImageUrl»: [

        {

          «language»: «no»,

          «value»: «https://keymgmtprod.blob.core.windows.net/keymgmt-product-attachments/NO/07090064260062/578/Passionfruit%2520Electrolytes.png»

        }

      ],

      «netContent»: [

        {

          «unitCode»: «H87»,

          «value»: «30»

        }

      ],

      «countryOfSaleCode»: [

        {

          «numeric»: «578»,

          «alpha2»: «NO»,

          «alpha3»: «NOR»

        }

      ],

      «dateUpdated»: «2024-03-17T13:03:34.41558Z»,

      «dateCreated»: «2024-03-17T13:03:34.41558Z»

    } ]

• Eksempel: Oppslag på enkelt GLN mot GS1 Norway GLN database

  Endepunkt:

  

  Beskrivelse

  Dette endepunktet gir deg mulighet til å gjøre oppslag på enkelt GLN. APIet returnerer informasjon om GLNet.

  Parameter – eksempel

  7080004038660

  Response

  {

    «location»: {

      «id»: «7080004038660»,

      «status»: «Active»,

      «stage»: «Live»,

      «companyPrefixId»: «70800»,

      «accountId»: 25357,

      «accountName»: «GS1 NORWAY»,

      «ownerCompany»: {

        «id»: 38536,

        «gln»: «7080004038660»,

        «externalId»: «2d956b3e-0c1d-4923-8a1f-2b6080dd1f8d»,

        «name»: «GS1 NORWAY»,

        «vat»: «971285850»,

        «organizationForm»: «FLI»

      },

      «createdAtTimeUtc»: «2024-01-18T17:35:06.4838224Z»,

      «deactivatedDateTime»: «0001-01-01T00:00:00Z»,

      «lastModifiedAtTimeUtc»: «2024-03-13T09:35:18.1455086Z»,

      «isLocked»: false,

      «isVisible»: true,

      «locationInfo»: {

        «glnTypes»: [

          «LEGAL_ENTITY»

        ],

        «locationTypes»: [],

        «name»: «GS1 NORWAY»,

        «address»: {

          «streetAddress»: «BRYNSVEIEN 11»,

          «city»: «OSLO»,

          «postalCode»: «0667»,

          «countryCode»: «578»,

          «country»: {

            «id»: «578»,

            «englishName»: «Norway»,

            «defaultLanguageCode»: «no»,

            «alpha2Code»: «NO»,

            «alpha3Code»: «NOR»

          },

          «coordinates»: {

            «srid»: «UTM33N»,

            «y»: «6648861»,

            «x»: «265820.1»

          },

          «verificationStatus»: «Valid»

        },

        «companyNum»: «971285850»,

        «companyName»: «GS1 NORWAY»,

        «organizationForm»: «FLI»,

        «isThirdPartyWarehouse»: false,

        «phoneNumber»: «22971320»,

        «reference»: «»,

        «partyRoleCodes»: [],

        «version»: 4,

        «validFromTimeUtc»: «2024-03-13T09:35:18.1455086Z»

      },

      «concurrencyToken»: «AAAAAAUmI88=»

    } }

• Eksempel: filtrert oppslag på ulike felt

  Endepunkt:

  

  Beskrivelse

  Dette endepunktet gir deg mulighet for å gjøre et filtrert oppslag mot GLN basen. Det kan filtreres på følgende egenskaper:

  • Lokasjonsnavn
  • GLN
  • EierGLN
  • Org.nr
  • Gateadresse
  • Status

  I eksempelet under er det benyttet org.nr.

  Request – eksempel

  {

    «filter»: {

      «companyNum»: {

        «value»: «813885492»,

        «type»: «Equals»

      }

    },

    «paging»: {

      «pageSize»: 200

    },

    «ordering»: [

      {

        «by»: «Id»,

        «direction»: «ASC»

      }

    ]

  }

  Response

  {

    «result»: {

      «info»: {

        «ordering»: [

          {

            «by»: «Id»,

            «direction»: «ASC»

          }

        ],

        «pageSize»: 200,

        «count»: 1,

        «canHaveMoreData»: false,

        «nextPageOffset»: [

          «7080010017017»

        ]

      },

      «items»: [

        {

          «id»: «7080010017017»,

          «status»: «Active»,

          «stage»: «Live»,

          «companyPrefixId»: «70800»,

          «accountId»: 47965,

          «accountName»: «EKÅS AS»,

          «ownerCompany»: {

            «id»: 51147,

            «gln»: «7080010017017»,

            «externalId»: «e518caf4-18d5-49e4-ac31-1306e11aceb7»,

            «name»: «EKÅS AS»,

            «vat»: «813885492»,

            «organizationForm»: «AS»

          },

          «createdAtTimeUtc»: «2024-03-14T08:28:55.0810077Z»,

          «deactivatedDateTime»: «0001-01-01T00:00:00Z»,

          «lastModifiedAtTimeUtc»: «2024-03-14T08:28:55.2663768Z»,

          «isLocked»: false,

          «isVisible»: true,

          «locationInfo»: {

            «glnTypes»: [

              «LEGAL_ENTITY»

            ],

            «locationTypes»: [],

            «name»: «EKÅS AS»,

            «address»: {

              «buildingNumber»: » «,

              «streetAddress»: «Marthe Plassens veg 13»,

              «city»: «KONGSVINGER»,

              «postalCode»: «2208»,

              «coordinates»: {

                «srid»: «UTM33N»,

                «y»: «6675973.01»,

                «x»: «333362.08»

              },

              «verificationStatus»: «Valid»

            },

            «companyNum»: «813885492»,

            «companyName»: «EKÅS AS»,

            «organizationForm»: «AS»,

            «isThirdPartyWarehouse»: false,

            «sourceChannel»: «Api»,

            «partyRoleCodes»: [],

            «causeOfGlnRegistration»: «EPD/Tradesolution»,

            «internalNote»: «»,

            «version»: 1,

            «validFromTimeUtc»: «2024-03-14T08:28:55.2663768Z»

          },

          «concurrencyToken»: «AAAAAAUmzF8=»

        }

      ]

    }

  }