RMA — Devoluções (fluxo paralelo)

O RMA gere devoluções de componentes ou equipamentos ao fornecedor, opcionalmente ligado a uma ordem de serviço.

Catálogos próprios (uma vez)

POST /gateway/return-type
Content-Type: application/json
Authorization: Bearer {token}

{
  "description": "Garantia"
}

POST /gateway/return-reason
Content-Type: application/json
Authorization: Bearer {token}

{
  "description": "Avaria de fabrico"
}

Criar o RMA

POST /gateway/rma
Content-Type: application/json
Authorization: Bearer {token}

{
  "rmaId": "RMA-2026-001",
  "rmaType": 1,
  "equipmentId": 123,
  "quantity": 1,
  "date": "2026-08-12T00:00:00Z",
  "returnType": "Garantia",
  "returnReason": "Avaria de fabrico",
  "warrantyValid": true,
  "itemNotModified": true,
  "serviceOrderGuid": "GUID-DA-ORDEM",
  "supplierKey": "F0010"
}

Obrigatório: rmaId (identificador de negócio).

Regras condicionais:

• rmaType 1 = Equipment → exige equipmentId
• tipo Component → exige componentKeyId
• returnType / returnReason, quando enviados, têm de existir nos catálogos

CRUD e listagem

Operação	Endpoint
Detalhe / actualizar / apagar	GET|PUT|DELETE /gateway/rma/{guid}
Listagem	GET /gateway/rma
Próximo id	GET /gateway/rma/next-id

Ver também

Como ligar um RMA a uma ordem de serviço (e os riscos de cada opção): visão geral — ligar RMA.

Erros comuns.