{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-rest/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"RFID API Guide","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"rfid-api-guide","__idx":0},"children":["RFID API Guide"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"purpose","__idx":1},"children":["Purpose"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yellow Dog supports RFID capabilities through third-party integration partners. To enable"," ","accurate interpretation of RFID tags printed by Yellow Dog, we expose the identifier values"," ","used as the basis for EPC (Electronic Product Code) generation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how Yellow Dog uses RFID tags to encode and detect unique EPC values."," ","It also explains how each Yellow Dog EPC value has a GTIN component which can be"," ","retrieved from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["epcGTIN"]}," property now available through our Item API endpoints."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-yellow-dog-epc-tags-use-gtin","__idx":2},"children":["How Yellow Dog EPC Tags Use GTIN"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each RFID label printed by Yellow Dog contains an EPC value encoded into the RFID tag’s"," ","EPC memory bank. This EPC value consists of a two part code:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A GTIN payload (epcGTIN)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A serial/sequence number to uniquely identify each tag instance"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example","__idx":3},"children":["Example"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GTIN: 10000000017999"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Serial/sequence number: 100000000004"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The resulting EPC memory bank value will be encoded as:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["HEX: 30340000006369d74876e804"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This corresponds to the EPC URI:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["urn:epc:tag:sgtin-96:1.0000000.101799.100000000004"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-epcgtin","__idx":4},"children":["What is epcGTIN?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The epcGTIN property appearing in Yellow Dog API endpoints refers to the"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["GTIN payload"]}," component of EPC values stored in RFID tags printed by Yellow Dog."," ","Each GTIN14 value is associated with only one item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since each item may be referenced by more than one GTIN14 value, the epcGTIN property"," ","is an array of GTIN14 values associated with that item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This array includes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The current GTIN used for newly printed RFID labels"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Any historical GTIN values previously used for that same item"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrators should use these GTIN values when decoding EPCs read from Yellow Dog RFID tags."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"important-notes","__idx":5},"children":["Important Notes"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gtin14-is-not-the-yellow-dog-sku","__idx":6},"children":["GTIN14 is Not the Yellow Dog SKU"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The GTIN14 value is a unique identifier stored per item in the Yellow Dog database."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Depending on the Yellow Dog system configuration, the generated GTIN-14 value"," ","may match the Yellow Dog item SKU"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["It is used specifically as part of RFID EPC generation"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-availability","__idx":7},"children":["API Availability"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The epcGTIN field is available in api responses from fetch API version 3.27.0 and above"," ","(Feb 2026)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The epcGTIN field is available only for database version 377 and above with a build code ≥"," ","2025.12.24."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["This is the first release where the GTIN schema exists."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-api-endpoints","__idx":8},"children":["Supported API Endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following endpoints now return epcGTIN property with an array of strings when the"," ","expand=GTIN is included in the request:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /stores/:id/items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /items"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["GET /items/:id"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response-format","__idx":9},"children":["Response Format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API returns epcGTIN as an array of GTIN14 strings."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-1","__idx":10},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"[\n  {\n    \"id\"\"description\": \"abcdx0\":,\n    \"itemDesc abcdx0\",\n\n    ... additional prexisting fields\n\n    \"epcGTIN\": [\n      \"10001000012457\"\n    ]\n  },\n  {\n    \"id\": \"beefx0\",\n    \"description\": \"itemDesc beefx0\",\n\n    ... additional prexisting fields\n\n    \"epcGTIN\": [\n      \"10001000012487\",\n      \"10000000045687\"\n    ]\n  }\n]\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"integration-workflow","__idx":11},"children":["Integration Workflow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When interacting with Yellow Dog-generated RFID tags, integrators should:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Read the EPC memory bank from the RFID tag"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Decode the EPC into its URI or component fields"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Extract the GTIN value"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Look up that GTIN in the integrator’s system mapping"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Resolve it back to the Yellow Dog ItemID or SKU"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use other Yellow Dog API endpoints for item-level operations"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":12},"children":["Summary"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The epcGTIN field enables integrators to correctly interpret Yellow Dog RFID tags by"," ","exposing the GTIN payloads used in EPC creation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This ensures consistent mapping between RFID reads and Yellow Dog item identities"," ","across all supported API endpoints."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]}]},"headings":[{"value":"RFID API Guide","id":"rfid-api-guide","depth":1},{"value":"Purpose","id":"purpose","depth":2},{"value":"How Yellow Dog EPC Tags Use GTIN","id":"how-yellow-dog-epc-tags-use-gtin","depth":2},{"value":"Example","id":"example","depth":3},{"value":"What is epcGTIN?","id":"what-is-epcgtin","depth":2},{"value":"Important Notes","id":"important-notes","depth":2},{"value":"GTIN14 is Not the Yellow Dog SKU","id":"gtin14-is-not-the-yellow-dog-sku","depth":3},{"value":"API Availability","id":"api-availability","depth":2},{"value":"Supported API Endpoints","id":"supported-api-endpoints","depth":2},{"value":"Response Format","id":"response-format","depth":2},{"value":"Example","id":"example-1","depth":3},{"value":"Integration Workflow","id":"integration-workflow","depth":2},{"value":"Summary","id":"summary","depth":2}],"frontmatter":{"seo":{"title":"RFID API Guide"}},"lastModified":"2026-03-16T22:30:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/rest/user-guide/13-rfid","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}