Estados

Un valor nuevo sería un cambio documentado y aditivo, así que un cliente debe tolerar un valor que no conozca. Los estados de las notas de crédito y de las proformas no son listas cerradas en absoluto: son texto libre, así que tolera cualquier valor ahí. Las tablas de abajo son las que más necesita un integrador; la tabla generada al final lista todos los enums de estado. La vista de la propia app sobre el ciclo de vida del pedido está en Ciclo de vida de un pedido.

El campo status de un pedido muestra el estado en bruto, uno de 12 valores. El filtro status de GET /api/v1/orders usa grupos operativos, la misma vista que la app. No envíes un valor en bruto al filtro ni esperes un grupo en el campo.

Para filtrar por varios grupos a la vez, usa statuses, una lista de hasta 50 valores que devuelve lo que coincida con cualquiera de ellos.

Una factura tiene dos campos. status es el ciclo de vida del documento; paymentStatus es el estado del pago. El filtro de lista paymentStatus usa los mismos valores que devuelve el campo paymentStatus, y GET /api/v1/invoices devuelve únicamente documentos de tipo factura.

Un presupuesto también tiene dos campos, y el detalle aplana la versión activa del presupuesto. status es el ciclo de vida del documento de esa versión; operativeStatus es el estado comercial, y PATCH /api/v1/quotes/{quoteId}/status lo cambia. Confirmar una versión deja las demás como superseded.

Esta tabla se genera a partir de la especificación y lista los enums de estado de todos los recursos, incluidos proyectos, tareas, contratos y el resto.