Saltar al contenido

Fila e histórico de encomendas (equipe)

GET/api/parcels/spaces/{spaceId}/parcels

Auth
Requiere token
Quién puede:
owner
admin
moderator
finance
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Só a equipe (owner, admin, moderador e financeiro). Filtros: `status`, `kind`, `q` (nome do destinatário, remetente, transportadora ou rastreio), `stalled` (só as `RECEIVED` paradas há pelo menos o prazo do space), `recipientProfileId`, `from` e `to` (datas `AAAA-MM-DD` no fuso da comunidade, pelo dia do recebimento). Mais novas primeiro. **Nenhuma resposta traz o código de retirada**, só `hasLockerCode`. Fotos vêm só com os ids; os links assinados saem em `GET /api/media/{id}/url` ou no detalhe.

Parámetros

NombreDóndeTipoDescripción
spaceIdobligatoriopathstring (uuid)
statusopcionalqueryRECEIVED | PICKED_UP | RETURNED | DISCARDED
kindopcionalqueryLETTER | PACKAGE | OTHER
qopcionalquerystring
stalledopcionalqueryboolean
recipientProfileIdopcionalquerystring (uuid)
fromopcionalquerystring
toopcionalquerystring
pageopcionalqueryinteger
limitopcionalqueryinteger

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200Encomendas da página.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.
500Erro interno do servidor.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/parcels/spaces/<spaceId>/parcels" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"