API para alteração de EPCs

Esse endpoint permite, através de um PATCH HTTP, alteração de informações dos EPCs.

fetch("http://SERVER:PORT/api/epc", {
  method: "PATCH",
  body: 
    [
        {
            "epc": "ABC456789012345678901234",
            "productReference": "P1",
            "batch": "B1",
            "placeReference": "P1",
            "status": "ACTIVE",
            "fraction": 0.0,
            "virtual": "false",
            "invoiceReference": "",
            "epcParent": "E1",
            "costCenterReference": "C1",
            "custom": {
                "custom": "customvalue",
                "customBoolean": "true"
            },
        },
        {
            "epc": "EPC2"...
        }
    ],
  headers: new Headers({
    Authorization: "Basic aW50ZWdyYcOnw6NvOjEyMzQ1Njc4",
    "Content-Type": "application/json",
  }),
})
  .then((response) => response.json())
  .then((json) => console.log(json))
  .catch((error) => console.log(error));

Parâmetros da URL

• SERVER - O IP ou DNS do servidor onde o sistema Valesoft está instalado
• PORT - A porta definida na instalação do sistema.

Campos do corpo da requisição:

• epc - EPC que será alterado (Obrigatório caso não informado lote)
• productReference: SKU/Código de referência do produto do EPC
• batch - Lote do EPC (Obrigatório caso não informado EPC)
• placeReference: Código de referência do local do EPC
• status: Status do EPC
• fraction: Fração do EPC
• virtual: Indicação se o EPC é ou não virtual
• invoiceReference: Código de referência do documento do EPC
• epcParent: EPC pai do EPC que será alterado
• costCenterReference: Código de referência do centro de custo
• custom: Campos customizados conforme cadastro no sistema

Resposta em caso de sucesso

{
	"epcs": [
		{
			"id": "3ed0b714-d3c2-4214-a478-6c95de9ceb83",
			"createdAt": "2024-04-27 03:32:36.488",
			"createdBy": "systemAction",
			"updatedAt": "2024-06-11 14:59:31.266",
			"updatedBy": "valesoft",
			"custom": {
				"custom": "customvalue",
				"customBoolean": true
			},
			"integrated": true,
			"epc": "ABC456789012345678901234",
			"productReference": {...},
			"batch": null,
			"place": null,
			"status": "ACTIVE",
			"fraction": 14.94,
			"virtual": false,
			"printerJobItem": null,
			"invoice":{...},
			"originInvoiceProduct":{...},
			"invoiceProductEpc":{...},
			"parent": null,
			"epcList": null,
			"costCenter": {...}
		}
	],
	"error": {}
}

Resposta em caso de erro

{
	"epcs": [],
	"error": {
      "epc": "Mensagem de erro"
    }
}

Obs: A chamada para esse endpoint necessita 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

Obs 2: Por convenção na chamada do endpoint de PATCH devem ser informados apenas os campos que serão alterados

Disponível a partir da versão 1.30.0