Appearance
Consulta de EPC's via API GET
Consulta a nível de EPC
Esse endpoint permite, através de um GET HTTP no caminho /api/epc consultar os EPC's:
shell
curl 'http://SERVER:PORT/api/epc?pageSize=100&pageIndex=0' \
-H 'Authorization: Basic aW50ZWdyYcOnw6NvOjEyMzQ1Njc4'Resposta em caso de sucesso
json
{
"items": [
{
"id": "686eeedc-222e-427a-bc39-76e3ba41f144",
"createdAt": "2025-01-14 11:51:50.948",
"createdBy": "systemAction",
"updatedAt": "2025-01-15 10:07:50.599",
"updatedBy": "systemAction",
"custom": {
"semana_semana": "03/2025\n"
},
"integrated": false,
"epc": "303862D4009C40FFF56571C8",
"productReference": {
"id": "63279890-28e6-4551-aaa2-b4293c52118d",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-11-28 13:39:30.749",
"updatedBy": "systemAction",
"product": {
"id": "23752865-c93e-4520-9839-1386fc1b71fd",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-12-05 11:40:09.266",
"updatedBy": "systemAction",
"custom": {
"compl_1": " ",
"compl_2": " ",
"ean_decathlon": null,
"desc_etiqueta_1": "BICICLETA ARO 20",
"desc_etiqueta_2": "APOLLO PRETO/LARANJ",
"cod_prod_cliente": null
},
"integrated": true,
"sku": "101200160003",
"description": "BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"barcode": "7898322521692",
"measureUnit": "PC",
"fraction": null,
"type": "PRODUCED",
"place": null,
"averageCost": null,
"externalId": "101200160003|101200160003",
"color": null,
"size": null,
"costCenter": null
},
"productGrid": null,
"sku": "101200160003",
"description": "101200160003 - BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"color": null,
"size": null,
"measureUnit": "PC",
"barcode": "7898322521692",
"fraction": null,
"type": "PRODUCED"
},
"batch": null,
"place": {
"id": "f4942cf6-6f4d-4d67-b9cb-2963b80656b9",
"createdAt": "2024-11-21 14:22:24.267",
"createdBy": "valesoft",
"updatedAt": "2024-11-21 14:22:24.267",
"updatedBy": "valesoft",
"custom": null,
"integrated": false,
"reference": "DEPOSITO",
"name": "DEPOSITO",
"address": null,
"localization": null,
"latitude": null,
"longitude": null,
"externalId": null,
"parent": null,
"type": "WAREHOUSE"
},
"status": "ACTIVE",
"fraction": null,
"virtual": false,
"blocked": false,
"printerJobItem": {
"id": "3df5771d-efac-4db4-9253-f5ef2f172c12",
"createdAt": "2025-01-15 10:05:32.957",
"createdBy": "valesoft",
"updatedAt": "2025-01-15 10:07:47.152",
"updatedBy": "systemAction",
"invoiceProduct": {
"id": "5fb483a1-bfbf-4bf6-8785-5ded7295e30c",
"createdAt": "2025-01-13 10:58:03.451",
"createdBy": "systemAction",
"updatedAt": "2025-01-13 10:58:03.451",
"updatedBy": "systemAction",
"custom": null,
"integrated": true,
"invoice": {
"id": "e24ff196-2176-4046-817f-352ddffadbc6",
"createdAt": "2025-01-13 10:58:03.435",
"createdBy": "systemAction",
"updatedAt": "2025-01-14 11:52:04.361",
"updatedBy": "systemAction",
"custom": null,
"integrated": true,
"reference": "914797",
"description": "Nota 914797",
"supplier": null,
"cloudClient": null,
"customer": null,
"place": null,
"flow": null,
"externalId": "914797",
"type": "MANUFACTURE",
"date": "2024-12-04",
"batch": null,
"label": {
"id": "0e762924-aba5-43d0-93bf-2452ca10fdee",
"createdAt": "2024-11-21 14:17:26.467",
"createdBy": "valesoft",
"updatedAt": "2024-11-21 14:17:26.467",
"updatedBy": "valesoft",
"name": "Nathor 100x50",
"zpl": "^XA\n^PW800\n^LL600\n^LT0\n^BY3,2,122^FT83,175^BEN,,Y,N\n^FH\\^FD{product.barcode}^FS\n^FT396,210^A0N,25,25^FH\\^CI28^FDLOTE: {invoice.reference}^FS^CI27\n^FT680,207^A0N,25,25^FH\\^CI28^FD{epc.custom.semana_semana}^FS^CI27\n^FT49,345^A0N,34,33^FH\\^CI28^FDEPC: {epc}^FS^CI27\n^FT625,403^BQN,2,6\n^FH\\^FDLA,{epc}^FS\n^FO49,35^GB750,191,3^FS\n\n^FT485,75^A0N,28,28^FH\\^CI28^FD{product.custom.desc_etiqueta_1}^FS^CI27 ; Descrição 1 posicionada acima do retângulo\n^FT465,166^A0N,41,41^FB330,2,0,L,50^FH\\^CI28^FD{product.custom.desc_etiqueta_2}^FS^CI27 ; Ajuste para deslocar ainda mais a segunda linha\n^FT50,285^A0N,34,33^FH\\^CI28^FDMARCA: {invoice.brand.name}^FS^CI27\n\n^PQ1,0,1,Y\n^XZ\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
"printer": null
},
"approvalStatus": "CREATED",
"hasReserve": false,
"printStatus": "DONE",
"costCenter": null,
"nextWorkflow": null,
"brand": {
"id": "2fff6f72-87b1-42a1-8fdd-d22adc26f2ac",
"createdAt": "2024-11-22 08:15:30.322",
"createdBy": "valesoft",
"updatedAt": "2024-11-22 08:15:30.322",
"updatedBy": "valesoft",
"custom": null,
"integrated": false,
"reference": "NATHOR",
"name": "NATHOR",
"label": {
"id": "0e762924-aba5-43d0-93bf-2452ca10fdee",
"createdAt": "2024-11-21 14:17:26.467",
"createdBy": "valesoft",
"updatedAt": "2024-11-21 14:17:26.467",
"updatedBy": "valesoft",
"name": "Nathor 100x50",
"zpl": "^XA\n^PW800\n^LL600\n^LT0\n^BY3,2,122^FT83,175^BEN,,Y,N\n^FH\\^FD{product.barcode}^FS\n^FT396,210^A0N,25,25^FH\\^CI28^FDLOTE: {invoice.reference}^FS^CI27\n^FT680,207^A0N,25,25^FH\\^CI28^FD{epc.custom.semana_semana}^FS^CI27\n^FT49,345^A0N,34,33^FH\\^CI28^FDEPC: {epc}^FS^CI27\n^FT625,403^BQN,2,6\n^FH\\^FDLA,{epc}^FS\n^FO49,35^GB750,191,3^FS\n\n^FT485,75^A0N,28,28^FH\\^CI28^FD{product.custom.desc_etiqueta_1}^FS^CI27 ; Descrição 1 posicionada acima do retângulo\n^FT465,166^A0N,41,41^FB330,2,0,L,50^FH\\^CI28^FD{product.custom.desc_etiqueta_2}^FS^CI27 ; Ajuste para deslocar ainda mais a segunda linha\n^FT50,285^A0N,34,33^FH\\^CI28^FDMARCA: {invoice.brand.name}^FS^CI27\n\n^PQ1,0,1,Y\n^XZ\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
"printer": null
},
"externalId": null
},
"conferenceDone": false
},
"productReference": {
"id": "63279890-28e6-4551-aaa2-b4293c52118d",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-11-28 13:39:30.749",
"updatedBy": "systemAction",
"product": {
"id": "23752865-c93e-4520-9839-1386fc1b71fd",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-12-05 11:40:09.266",
"updatedBy": "systemAction",
"custom": {
"compl_1": " ",
"compl_2": " ",
"ean_decathlon": null,
"desc_etiqueta_1": "BICICLETA ARO 20",
"desc_etiqueta_2": "APOLLO PRETO/LARANJ",
"cod_prod_cliente": null
},
"integrated": true,
"sku": "101200160003",
"description": "BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"barcode": "7898322521692",
"measureUnit": "PC",
"fraction": null,
"type": "PRODUCED",
"place": null,
"averageCost": null,
"externalId": "101200160003|101200160003",
"color": null,
"size": null,
"costCenter": null
},
"productGrid": null,
"sku": "101200160003",
"description": "101200160003 - BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"color": null,
"size": null,
"measureUnit": "PC",
"barcode": "7898322521692",
"fraction": null,
"type": "PRODUCED"
},
"type": "PRODUCED",
"batch": null,
"quantity": 200,
"fraction": null,
"packingQuantity": null,
"externalId": "914797|101200160003"
},
"epcPlace": null,
"status": "DONE",
"ordination": 200,
"epcFraction": null,
"epcCustom": null,
"costCenter": null
},
"invoice": {
"id": "44b079e8-00cb-4aad-a5c1-958a3c8d956e",
"createdAt": "2025-01-15 07:39:45.704",
"createdBy": "CONTAGEM_MON",
"updatedAt": "2025-01-15 07:39:45.704",
"updatedBy": "CONTAGEM_MON",
"custom": null,
"integrated": false,
"reference": "RMS0000016",
"description": "Remessa 15/01/2025 07:39:45",
"supplier": null,
"cloudClient": null,
"customer": null,
"place": null,
"flow": null,
"externalId": null,
"type": "SHIPPING",
"date": "2025-01-15",
"batch": null,
"label": null,
"approvalStatus": "CREATED",
"hasReserve": false,
"printStatus": "PENDING",
"costCenter": null,
"nextWorkflow": null,
"brand": null,
"conferenceDone": false
},
"originInvoiceProduct": {
"id": "5fb483a1-bfbf-4bf6-8785-5ded7295e30c",
"createdAt": "2025-01-13 10:58:03.451",
"createdBy": "systemAction",
"updatedAt": "2025-01-13 10:58:03.451",
"updatedBy": "systemAction",
"custom": null,
"integrated": true,
"invoice": {
"id": "e24ff196-2176-4046-817f-352ddffadbc6",
"createdAt": "2025-01-13 10:58:03.435",
"createdBy": "systemAction",
"updatedAt": "2025-01-14 11:52:04.361",
"updatedBy": "systemAction",
"custom": null,
"integrated": true,
"reference": "914797",
"description": "Nota 914797",
"supplier": null,
"cloudClient": null,
"customer": null,
"place": null,
"flow": null,
"externalId": "914797",
"type": "MANUFACTURE",
"date": "2024-12-04",
"batch": null,
"label": {
"id": "0e762924-aba5-43d0-93bf-2452ca10fdee",
"createdAt": "2024-11-21 14:17:26.467",
"createdBy": "valesoft",
"updatedAt": "2024-11-21 14:17:26.467",
"updatedBy": "valesoft",
"name": "Nathor 100x50",
"zpl": "^XA\n^PW800\n^LL600\n^LT0\n^BY3,2,122^FT83,175^BEN,,Y,N\n^FH\\^FD{product.barcode}^FS\n^FT396,210^A0N,25,25^FH\\^CI28^FDLOTE: {invoice.reference}^FS^CI27\n^FT680,207^A0N,25,25^FH\\^CI28^FD{epc.custom.semana_semana}^FS^CI27\n^FT49,345^A0N,34,33^FH\\^CI28^FDEPC: {epc}^FS^CI27\n^FT625,403^BQN,2,6\n^FH\\^FDLA,{epc}^FS\n^FO49,35^GB750,191,3^FS\n\n^FT485,75^A0N,28,28^FH\\^CI28^FD{product.custom.desc_etiqueta_1}^FS^CI27 ; Descrição 1 posicionada acima do retângulo\n^FT465,166^A0N,41,41^FB330,2,0,L,50^FH\\^CI28^FD{product.custom.desc_etiqueta_2}^FS^CI27 ; Ajuste para deslocar ainda mais a segunda linha\n^FT50,285^A0N,34,33^FH\\^CI28^FDMARCA: {invoice.brand.name}^FS^CI27\n\n^PQ1,0,1,Y\n^XZ\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
"printer": null
},
"approvalStatus": "CREATED",
"hasReserve": false,
"printStatus": "DONE",
"costCenter": null,
"nextWorkflow": null,
"brand": {
"id": "2fff6f72-87b1-42a1-8fdd-d22adc26f2ac",
"createdAt": "2024-11-22 08:15:30.322",
"createdBy": "valesoft",
"updatedAt": "2024-11-22 08:15:30.322",
"updatedBy": "valesoft",
"custom": null,
"integrated": false,
"reference": "NATHOR",
"name": "NATHOR",
"label": {
"id": "0e762924-aba5-43d0-93bf-2452ca10fdee",
"createdAt": "2024-11-21 14:17:26.467",
"createdBy": "valesoft",
"updatedAt": "2024-11-21 14:17:26.467",
"updatedBy": "valesoft",
"name": "Nathor 100x50",
"zpl": "^XA\n^PW800\n^LL600\n^LT0\n^BY3,2,122^FT83,175^BEN,,Y,N\n^FH\\^FD{product.barcode}^FS\n^FT396,210^A0N,25,25^FH\\^CI28^FDLOTE: {invoice.reference}^FS^CI27\n^FT680,207^A0N,25,25^FH\\^CI28^FD{epc.custom.semana_semana}^FS^CI27\n^FT49,345^A0N,34,33^FH\\^CI28^FDEPC: {epc}^FS^CI27\n^FT625,403^BQN,2,6\n^FH\\^FDLA,{epc}^FS\n^FO49,35^GB750,191,3^FS\n\n^FT485,75^A0N,28,28^FH\\^CI28^FD{product.custom.desc_etiqueta_1}^FS^CI27 ; Descrição 1 posicionada acima do retângulo\n^FT465,166^A0N,41,41^FB330,2,0,L,50^FH\\^CI28^FD{product.custom.desc_etiqueta_2}^FS^CI27 ; Ajuste para deslocar ainda mais a segunda linha\n^FT50,285^A0N,34,33^FH\\^CI28^FDMARCA: {invoice.brand.name}^FS^CI27\n\n^PQ1,0,1,Y\n^XZ\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
"printer": null
},
"externalId": null
},
"conferenceDone": false
},
"productReference": {
"id": "63279890-28e6-4551-aaa2-b4293c52118d",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-11-28 13:39:30.749",
"updatedBy": "systemAction",
"product": {
"id": "23752865-c93e-4520-9839-1386fc1b71fd",
"createdAt": "2024-11-28 13:39:30.749",
"createdBy": "systemAction",
"updatedAt": "2024-12-05 11:40:09.266",
"updatedBy": "systemAction",
"custom": {
"compl_1": " ",
"compl_2": " ",
"ean_decathlon": null,
"desc_etiqueta_1": "BICICLETA ARO 20",
"desc_etiqueta_2": "APOLLO PRETO/LARANJ",
"cod_prod_cliente": null
},
"integrated": true,
"sku": "101200160003",
"description": "BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"barcode": "7898322521692",
"measureUnit": "PC",
"fraction": null,
"type": "PRODUCED",
"place": null,
"averageCost": null,
"externalId": "101200160003|101200160003",
"color": null,
"size": null,
"costCenter": null
},
"productGrid": null,
"sku": "101200160003",
"description": "101200160003 - BICICLETA ARO 20 APOLLO PRETO/LARANJ",
"color": null,
"size": null,
"measureUnit": "PC",
"barcode": "7898322521692",
"fraction": null,
"type": "PRODUCED"
},
"type": "PRODUCED",
"batch": null,
"quantity": 200,
"fraction": null,
"packingQuantity": null,
"externalId": "914797|101200160003"
},
"invoiceProductEpc": null,
"parent": null,
"epcList": [],
"costCenter": null
}
],
"totalItems": 1
}Descrição dos campos
Campos da API:
id- Identificador do EPCcreatedAt- Criado emcreatedBy- Criado porupdatedAt- Atualizado emupdatedBy- Atualizado porcustom- Campo Custom do EPCintegrated- Integradoepc- EPCproductReference- Produto Referênciabatch- Loteplace- Localstatus- Status do EPCfraction- Fraçãovirtual- Virtualblocked- BloqueadoprinterJobItem- Item da Impressãoinvoice- DocumentooriginInvoiceProduct- OrigeminvoiceProductEpc- Dados do Item do Documentoparent- PaicostCenter- Centro de Custo
Autenticação
A chamada para esses endpoints necessitam autenticação do tipo Basic(Base64 encoded) com credenciais de um usuário devidamente cadastrado no sistema Valesoft. Ex: Usuário integração com senha 12345678
integração:12345678=> Base64 encoded =>aW50ZWdyYcOnw6NvOjEyMzQ1Njc4- Header de autenticação =>
Authorization: Basic aW50ZWdyYcOnw6NvOjEyMzQ1Njc4
Parâmetros da requisição:
SERVER- O IP ou DNS do servidor onde o sistema Valesoft está instaladoPORT- A porta definida na instalação do sistema.pageIndex- Índice da página atual de resultado, iniciando em 0pageSize- Quantidade de itens da página atual de resultado
Filtragem dos resultados
É possível filtrar através de parâmetros query por um EPC específico ou qualquer outro campo da API. Exemplo:
http://SERVER:PORT/api/epc?pageSize=100&pageIndex=0&epc=303862D4009C40FFF56571C8