Pedidos
Pedidos con su plan de pagos y el pago de cada plazo, sin datos de tarjeta.
Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Pedidos con su plan de pagos y el pago de cada plazo, sin datos de tarjeta.
Pedidos de la marca con estado, fecha e importe. Sin datos de pago ni emails.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/orders.list |
| Herramienta MCP | orders_list |
| Alcance | orders.read |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
| Widget | list |
Entrada
{
cursor?: string // ≤ 512 · Opaque cursor from a previous `nextCursor`.
limit?: integer // 1–50 · default 20
}Salida
{
items: Array<{
id: string // uuid
number: string
status: string
total: number
currency: string
createdAt: string
}>
nextCursor: string | null
}Los pedidos de la marca, los más nuevos primero, con su total con IVA, lo pagado y su plan de pagos en uno, dos o tres plazos. Se filtran por por pagar, pagados o devueltos.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/orders.screen.list |
| Herramienta MCP | orders_screen_list |
| Alcance | orders.read |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | API, MCP, Pantallas, Apps, Nödo |
| Estado | Disponible |
Entrada
{
filter?: "all" | "due" | "paid" | "refunded"
offset?: integer // 0–100000
limit?: integer // 1–50
}Salida
{
orders: Array<{
id: string // uuid
number: string
title: string
itemCount: integer // -9007199254740991–9007199254740991
createdAt: string
currency: string
totalGrossMinor: integer // -9007199254740991–9007199254740991
paidGrossMinor: integer // -9007199254740991–9007199254740991
state: "paid" | "due" | "overdue" | "processing" | "scheduled" | "refunded"
installments: Array<{
index: integer // -9007199254740991–9007199254740991
state: "paid" | "processing" | "due" | "overdue" | "scheduled" | "refunded" | "unavailable"
grossMinor: integer // -9007199254740991–9007199254740991
}>
nextDueGrossMinor: integer | null
}>
counts: {
all: integer // -9007199254740991–9007199254740991
due: integer // -9007199254740991–9007199254740991
paid: integer // -9007199254740991–9007199254740991
refunded: integer // -9007199254740991–9007199254740991
}
nextOffset: integer // -9007199254740991–9007199254740991
hasMore: boolean
}Un pedido con sus líneas, la base, el IVA y el total, quién paga, los trabajos que entrega y su plan de pagos: cada plazo con su parte, lo que lo dispara, su importe y su estado.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/orders.screen.get |
| Herramienta MCP | orders_screen_get |
| Alcance | orders.read |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | API, MCP, Pantallas, Apps, Nödo |
| Estado | Disponible |
Entrada
{
orderId: string // uuid
}Salida
{
order: {
id: string // uuid
number: string
title: string
createdAt: string
currency: string
state: "paid" | "due" | "overdue" | "processing" | "scheduled" | "refunded"
lines: Array<{
title: string
quantity: number
netMinor: integer // -9007199254740991–9007199254740991
}>
totals: {
netMinor: integer // -9007199254740991–9007199254740991
taxMinor: integer // -9007199254740991–9007199254740991
grossMinor: integer // -9007199254740991–9007199254740991
withholdingMinor: integer // -9007199254740991–9007199254740991
paidGrossMinor: integer // -9007199254740991–9007199254740991
remainingGrossMinor: integer // -9007199254740991–9007199254740991
}
payer: {
name: string | null
taxId: string | null
}
| null
works: Array<{
id: string // uuid
name: string
}>
installments: Array<{
taskId: string | null
workId: string | null
installmentId: string | null
moment: "on_accept" | "midway" | "on_delivery" | null
index: integer // -9007199254740991–9007199254740991
kind: "partial" | "final" | "single"
percentBps: integer | null
label: string
netMinor: integer // -9007199254740991–9007199254740991
taxMinor: integer // -9007199254740991–9007199254740991
withholdingMinor: integer // -9007199254740991–9007199254740991
grossMinor: integer // -9007199254740991–9007199254740991
state: "paid" | "processing" | "due" | "overdue" | "scheduled" | "refunded" | "unavailable"
dueDate: string | null
paidAt: string | null
method: string | null
}>
nextDueTaskId: string | null
nextDueInstallmentId: string | null
nextDuePayment: {
taskId: string // uuid
grossMinor: integer // -9007199254740991–9007199254740991
currency: string
}
| null
hasInvoice: boolean
}
canPay: boolean
}Prepara el pago del plazo de un pedido que toca pagar (el importe sale siempre del servidor) para que la persona lo confirme con Stripe.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/orders.installments.start |
| Herramienta MCP | orders_installments_start |
| Alcance | orders.write |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
installmentId: string // uuid
}Salida
{
installment: {
id: string // uuid
orderId: string // uuid
position: integer // -9007199254740991–9007199254740991
status: string
grossMinor: integer // -9007199254740991–9007199254740991
currency: string
}
clientSecret: string | null
publishableKey: string
sheet?: {
publishableKey: string
customerId: string | null
customerSessionClientSecret: string | null
merchantCountryCode: "ES"
merchantDisplayName: string
googlePayEnvironment: "test" | "production"
}
| null
}Después de confirmar en Stripe, vuelve a leer el pago y deja el plazo pagado o en proceso.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/orders.installments.confirm |
| Herramienta MCP | orders_installments_confirm |
| Alcance | orders.write |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | Pantallas, Apps |
| Estado | Disponible |
Entrada
{
installmentId: string // uuid
}Salida
{
id: string // uuid
orderId: string // uuid
position: integer // -9007199254740991–9007199254740991
status: string
grossMinor: integer // -9007199254740991–9007199254740991
currency: string
}Equipo de Nömad: pide el siguiente plazo de un pedido cuando el trabajo llega a él. Avisa a quienes pagan en la marca con el importe, la fecha y el botón para pagarlo.
| Campo | Valor |
|---|---|
| Tipo | Escritura |
| Método HTTP | POST /api/v1/orders.installments.request |
| Herramienta MCP | orders_installments_request |
| Alcance | orders.write |
| Rol mínimo | Facturación |
| Confirmación humana | No |
| Puertas | API, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
installmentId: string // uuid
dueDate?: string | null
}Salida
{
id: string // uuid
orderId: string // uuid
position: integer // -9007199254740991–9007199254740991
status: string
grossMinor: integer // -9007199254740991–9007199254740991
currency: string
}Actualizado el 1 de enero de 1970