> ## Documentation Index > Fetch the complete documentation index at: https://docs.stockshift.io/llms.txt > Use this file to discover all available pages before exploring further. # Factura un pedido de venta > Crea una factura en borrador de lo que se haya enviado del pedido y aún no se haya facturado. Si la organización factura antes de enviar, factura lo pedido. Los precios vienen del pedido y el impuesto de la tasa del cliente. Se rechaza cuando no queda nada por facturar. Requiere el permiso `sales.invoices.manage` y un token con `sales:write`. ## OpenAPI ````yaml /openapi.es.json post /sales/orders/{order}/invoices openapi: 3.1.2 info: title: StockShift API version: 1.0.0 description: >- La API REST de StockShift. Empieza con las guías de autenticación, alcances, paginación, errores y webhooks. servers: - url: https://app.stockshift.io/api/v1 description: Producción - url: https://app.beta.stockshift.io/api/v1 description: Beta security: - apiKey: [] - oauth2: [] tags: - name: Acciones de existencias con testigo description: >- Retiene una acción de existencias para una segunda persona, que recuenta a ciegas y firma, y lee ambas firmas. Las existencias solo cambian cuando el testigo firma. - name: Existencias del artículo description: >- Todo sobre las existencias de un artículo: dónde están, qué está prometido, cómo se rastrean y cuánto cuestan. - name: Transferencias description: >- Mueve existencias de una ubicación a otra, con tiempo en tránsito entre el envío y la recepción. - name: Costos de importación description: >- Agrega flete, aranceles y otros cargos al costo de las existencias que recibiste. - name: Conteos de existencias description: >- Cuenta lo que hay en el estante, compáralo con lo que StockShift espera y contabiliza la diferencia cuando alguien la apruebe. - name: Ubicaciones description: >- Los almacenes, salas y contenedores donde se guardan las existencias. La mayoría de las llamadas de existencias necesitan un ID de ubicación de aquí. - name: Periodos description: >- Cierra cada mes una vez informado: bloquea lo que tiene fecha en él, comprueba que no quede nada abierto y conserva el valor de las existencias al final. - name: Importaciones de inventario description: >- Carga las existencias iniciales desde un archivo CSV, con una vista previa antes de contabilizar nada. - name: Solicitudes de liberación description: >- Pide a Calidad que libere existencias retenidas, y rechaza o retira la solicitud. Liberar las existencias la cierra. - name: Firmantes description: >- Quién puede firmar acciones de existencias con testigo: de quién se verificó la identidad, cómo y cuándo, y las firmas fallidas que deben ver los revisores. - name: Existencias description: >- Cuánto hay de cada artículo y dónde. Consulta los niveles, ahora o en una fecha pasada, y contabiliza ajustes cuando se encuentren, pierdan o dañen existencias. - name: Reglas de testigo description: >- Qué acciones de existencias esperan a que una segunda persona vuelva a contar y firme, como retirar una sustancia controlada. - name: Reglas de asignación description: >- Qué lotes se toman primero cuando se reservan o se envían existencias, como primero en caducar, primero en salir. - name: Configuración de inventario description: >- Cómo maneja la organización las existencias, por ejemplo si pueden quedar en negativo y cómo se costean. - name: Lotes description: Lotes de existencias que comparten un número de lote, y cuándo vencen. - name: Movimientos description: >- El libro detrás de cada nivel de existencias. Los movimientos nunca se editan; se corrigen revirtiéndolos. - name: Números de serie description: Unidades con seguimiento individual y dónde está cada una ahora. - name: Movimientos de existencias description: >- Mueve existencias de una ubicación a otra en un solo paso, por ejemplo de un muelle a un estante, y deshaz un movimiento completo. - name: Vistas previas masivas description: >- Revisa una lista de líneas de existencias antes de un movimiento masivo, un ajuste, una retención o una impresión, y ve qué debe decidirse en cada línea. - name: Artículos description: >- Los productos y materiales que almacenas, compras, fabricas o vendes. El ID o el SKU de un artículo es lo que piden la mayoría de los demás endpoints. - name: Familias description: >- Grupos de artículos que solo se diferencian por opciones como la talla o el color, y las variantes que se hacen con ellos. - name: Importaciones de catálogo description: >- Crea o actualiza artículos desde un archivo CSV, con una vista previa antes de guardar nada. - name: Campos personalizados description: >- Campos adicionales que la organización agrega a sus artículos. Defínelos aquí y luego asigna sus valores en cada artículo. - name: Biblioteca de productos description: >- Busca un producto por su GTIN y crea un artículo con lo que la biblioteca sabe de él. - name: Unidades description: >- Unidades de medida, como each, box o kg. Los artículos se cuentan en una unidad base y se convierten desde las demás. - name: Escaneo description: >- Convierte un código de barras escaneado en el artículo, la unidad o la pieza etiquetada que identifica. - name: Proveedores description: >- Las empresas a las que compras, las personas con las que tratas allí y lo que te cobran. - name: Órdenes de compra description: >- Órdenes a proveedores. Crea un borrador, apruébalo, envíalo y recibe la mercancía contra él. - name: Importaciones de compras description: Carga proveedores y sus catálogos desde archivos CSV. - name: Configuración de compras description: >- Cómo compra la organización, por ejemplo el umbral de aprobación y cuánto puede superar una recepción a la orden. - name: Recepciones description: >- Mercancía recibida contra órdenes de compra. Revierte una recepción para corregirla o imprime etiquetas de lo que llegó. - name: Proveedores del artículo description: Qué proveedores venden un artículo, y a qué precio. - name: Exportaciones de compras description: >- Descarga proveedores o sus catálogos como CSV, en las mismas columnas que lee la importación. - name: Pedidos de venta description: >- Pedidos de clientes. Toma uno como borrador, confírmalo para reservar existencias, luego envíalo y factúralo. - name: Clientes description: Las empresas a las que vendes y las personas con las que tratas allí. - name: Facturas description: Facturas de lo que has vendido y los pagos registrados contra ellas. - name: Listas de precios description: >- Los precios que paga un cliente, con escalas por cantidad. Asígnale una lista de precios a un cliente y sus pedidos se calculan solos. - name: Cotizaciones description: >- Ofertas a clientes. Una cotización aceptada se convierte en un pedido de venta. - name: Tasas de impuestos description: Las tasas de impuesto sobre las ventas con las que se cobran las facturas. - name: Importaciones de ventas description: Carga clientes y listas de precios desde archivos CSV. - name: Devoluciones description: >- Mercancía que los clientes devuelven: autoriza la devolución, luego recíbela en las existencias y acredítala. - name: Envíos description: Lo que salió del edificio por cada pedido de venta. - name: Configuración de ventas description: >- Cómo vende la organización, por ejemplo cuándo se reservan las existencias y si las facturas pueden salir antes del envío. - name: Certificados de conformidad description: >- Certificados firmados de que los productos de un envío cumplen con el pedido, conservados exactamente como se firmaron. - name: Precios description: >- Consulta cuánto pagaría un cliente por una cantidad de un artículo antes de ponerlo en un pedido. - name: Exportaciones de ventas description: >- Descarga clientes y listas de precios como CSV, en las mismas columnas que lee la importación. - name: Órdenes de fabricación description: >- Órdenes para fabricar algo. Libera una orden de fabricación al piso, consume sus piezas y complétala hacia las existencias. - name: Reparaciones description: >- Reparaciones de unidades que los clientes devuelven: revisa la garantía, registra las piezas puestas y retiradas, y luego completa la reparación o factúrala. - name: Rutas description: >- Los pasos por los que pasa una orden de fabricación y el centro de trabajo en el que se ejecuta cada paso. - name: Centros de trabajo description: Las máquinas, celdas o equipos donde se hacen los pasos de una ruta. - name: Plazos de garantía description: >- Cuánto tiempo un artículo está en garantía y si cuenta desde el envío o la fabricación, con condiciones propias para algunos clientes. - name: Trazabilidad description: >- Rastrea un lote o número de serie hacia atrás hasta lo que entró en él, o hacia adelante hasta aquello en lo que entró. - name: Configuración de fabricación description: >- Cómo fabrica la organización, por ejemplo si las operaciones pueden superponerse y el estado en el que entran los productos terminados. - name: Programación description: Planifica las órdenes de fabricación abiertas en días hábiles. - name: Variaciones de costo description: >- Dónde una orden de fabricación completada costó más o menos que su costo estándar. - name: BOM description: >- Listas de materiales: las piezas y cantidades que forman un artículo, guardadas como revisiones. - name: Cambios de ingeniería description: >- Órdenes de cambio que proponen revisiones nuevas de BOM y las liberan una vez aprobadas. - name: Importaciones de ingeniería description: Carga listas de materiales desde un archivo CSV o una exportación de CAD. - name: Configuración de Ingeniería description: >- Cómo gestiona la organización los cambios de ingeniería, por ejemplo cuántas aprobaciones necesita una orden de cambio. - name: Exportaciones de ingeniería description: >- Descarga listas de materiales como CSV, en las mismas columnas que lee la importación. - name: Dónde se usa description: >- Encuentra todas las BOM en las que aparece un artículo, antes de cambiarlo o retirarlo. - name: Planes de inspección description: >- Qué revisar, en qué artículos y cuántos: las características, el muestreo y el punto de inspección de cada plan. - name: Inspecciones description: >- Inspecciones abiertas por recepciones, operaciones y órdenes de fabricación. Registra sus resultados para aprobar o rechazar las existencias que retienen. - name: Pronósticos description: >- La demanda esperada de cada artículo, semana por semana, y los cambios que hacen los planificadores. - name: Escenarios description: Copias del pronóstico para probar cambios sin tocar el plan real. - name: Demanda description: >- Demanda pasada de un artículo en una ubicación, a partir de la cual se construyen los pronósticos. - name: Sugerencias description: >- Lo que el plan dice que se compre o se fabrique. Acepta uno para generar la orden de compra o la orden de fabricación, o descártalo. - name: Reabastecimiento description: >- Cómo se mantiene cada artículo en existencias en cada ubicación: puntos de reorden, mínimos y máximos o revisión periódica. - name: Días festivos description: >- Días en que la organización no trabaja, que el plan omite al contar plazos de entrega. - name: Configuración de planificación description: >- Cómo planifica la organización, por ejemplo el horizonte del pronóstico y el nivel de servicio. - name: Automatizaciones description: >- Reglas que ejecutan pasos cuando ocurre algo o según una programación. Edita el borrador y luego publícalo para activarla. - name: Ejecuciones description: >- Cada vez que se ejecutó una automatización: qué la inició, qué hizo cada paso y dónde falló. - name: Aprobaciones description: >- Ejecuciones en pausa a la espera de que una persona las apruebe o rechace antes de continuar. - name: Configuración de automatización description: >- Límites de toda la organización para las automatizaciones, como las ejecuciones por minuto y si alguien puede aprobar su propia ejecución. - name: Plantillas de automatización description: Automatizaciones prediseñadas para empezar. - name: Eventos description: >- Los eventos que pueden activar una automatización y los datos que lleva cada uno. - name: Catálogo de pasos description: >- Todos los pasos que puede usar una automatización y las entradas que toma cada uno. - name: Vistas description: >- Reportes guardados: el conjunto de datos, los filtros, la agrupación y el gráfico que alguien configuró, listos para ejecutarse de nuevo. - name: Paneles description: Páginas de gráficos y KPI dispuestos en una cuadrícula. - name: Conjuntos de datos description: >- Los datos sobre los que puedes reportar y los campos de cada uno. Empieza aquí para crear un reporte. - name: Programaciones description: >- Envía un reporte por correo electrónico según una programación, o avisa a alguien cuando un valor cruza un umbral. - name: KPI description: >- Cifras individuales que vale la pena vigilar, definidas como una fórmula sobre un conjunto de datos. - name: Panel description: >- Las cifras de la pantalla de inicio de la app, por si quieres mostrar los mismos números en otro lugar. - name: Carpetas de vistas description: Carpetas que mantienen organizadas las vistas guardadas. - name: Exportaciones de Insights description: >- Exporta un informe a un archivo. Las exportaciones grandes se ejecutan en segundo plano y están listas para descargar más tarde. - name: Plantillas de reportes description: >- Reportes prediseñados, como el envejecimiento de existencias, para empezar una vista. - name: Reportes description: >- Ejecuta la definición de un reporte y obtén sus filas o su gráfico, sin guardarla antes. - name: Plantillas de panel description: Paneles prediseñados para empezar. - name: Fórmulas description: >- Comprueba una fórmula contra un conjunto de datos antes de guardarla en un KPI o en un campo calculado. - name: Conexiones description: >- Cuentas conectadas en otros sistemas, qué sincroniza cada una y el historial de sus ejecuciones de sincronización. - name: Envío description: >- Tarifas de transportistas, las etiquetas compradas para pedidos y devoluciones, y los escaneos que rastrean cada paquete. - name: Migraciones description: >- Trae registros de otro sistema: prepara archivos o una extracción, asigna las columnas, revisa las filas, confírmalas y deshaz la confirmación. - name: Abastecimiento description: >- Precios y existencias de piezas de distribuidores: busca en un distribuidor conectado, vincula artículos con sus piezas y calcula el precio de una revisión de BOM. - name: CAD description: >- Ensambles de CAD y PLM: lista los ensambles de una herramienta conectada y vigila aquellos cuyas liberaciones se convierten en importaciones de BOM. - name: Exportación de datos description: >- Todo lo que guarda la organización en un solo ZIP de archivos CSV y de líneas JSON, para que el propietario lo descargue. - name: Direcciones fiscales description: >- Las direcciones por las que un servicio de impuestos conectado calcula el impuesto de cada venta, comprobadas con él. - name: Conectores description: >- Los sistemas a los que puede conectarse StockShift y lo que puede sincronizar cada conector. - name: Conjuntos de etiquetas description: >- Todos los lotes de etiquetas impresos, para que puedas encontrar uno de nuevo y reimprimirlo. - name: Plantillas de etiquetas description: Los diseños con que se imprimen las etiquetas. - name: Piezas description: >- Busca una pieza etiquetada a partir del código de su etiqueta: el artículo, el lote o la serie y cuánto contiene. - name: Marca y plantillas description: >- El logotipo, los colores, los términos y los campos personalizados con que se imprime cada cotización, orden de compra, factura y lista de empaque. - name: Apps móviles description: >- Cómo las apps móviles de StockShift registran un dispositivo, inician sesión y se mantienen sincronizadas con el servidor. - name: Dispositivos description: >- Los teléfonos y escáneres registrados en la organización. Bloquea uno perdido, bórralo o retíralo. - name: Configuración del escáner description: >- Hojas imprimibles de códigos de barras que configuran un escáner de hardware, y las preferencias de escáner de cada persona. - name: Inscripciones description: Crea los códigos QR que inscriben dispositivos compartidos y quioscos. - name: Feeds de sincronización description: >- Descarga una instantánea de los datos que necesita un dispositivo y luego obtén los cambios desde entonces. - name: Comandos de sincronización description: >- Envía los cambios que un dispositivo hizo sin conexión. Cada comando se aplica una sola vez, sin importar cuántas veces se envíe. - name: Archivos de sincronización description: >- Descarga los archivos, como imágenes de artículos, a los que apunta un feed. - name: Perfil description: >- La cuenta propia de la persona que inició sesión: sus datos, contraseña, llaves de acceso, segundo factor y sesiones. - name: Notificaciones description: >- La bandeja de entrada del miembro que inició sesión: lo que lo necesita, lo que no ha leído, y de qué se le avisa y cómo. - name: Invitaciones description: Invita a personas a unirse a la organización y acepta una invitación. - name: Roles description: >- Roles y los permisos de cada uno. Un miembro puede hacer lo que sus roles permiten. - name: Acceso del personal description: >- Solicitudes del soporte de StockShift para ver los datos de la organización, que un propietario debe conceder. - name: Equipo description: Las personas de la organización y los roles que tienen. - name: Claves de API description: >- Crea y revoca las claves que usan los scripts y las integraciones para llamar a esta API. - name: Organizaciones description: Las organizaciones a las que pertenece la persona que inició sesión. - name: Firmas description: >- Algunas acciones necesitan una firma electrónica. Obtén aquí un token de firma y envíalo con la llamada. - name: Registro description: Regístrate para obtener una cuenta y una organización nuevas. - name: Organización description: >- Política de toda la organización: cuánto tiempo se conservan los registros, reglas de sesión, retenciones legales y cierre de la organización. - name: Aceptaciones legales description: >- Las versiones de los Términos de servicio y de la Política de privacidad que aceptó la organización, las versiones que esperan a un propietario y un certificado de cada aceptación. - name: Dirección description: >- La dirección de facturación que aparece en las facturas de la organización. - name: Historial description: Quién cambió qué campo de un registro, cuándo y a partir de qué. - name: Certificados de destrucción description: Comprueba que un certificado de destrucción de datos es auténtico. - name: Facturación description: >- Consulta o cambia el plan, compra paquetes de ejecuciones para automatizaciones, ve las facturas y actualiza el método de pago. - name: Webhooks description: >- Registra URL para que te avisen cuando pasen cosas, y consulta cada entrega y su respuesta. - name: Apps OAuth description: >- Las apps de terceros que los miembros conectaron mediante OAuth. Revoca una para cortar su acceso. - name: Hooks REST description: >- Para apps conectadas como Zapier: suscribe un evento a una URL y cancela la suscripción. - name: Servidor MCP description: >- Deja que un asistente de IA trabaje en StockShift a través del Model Context Protocol, con los mismos permisos que el miembro que lo conecta. - name: Eventos recientes description: >- Los últimos eventos de un tipo, tal como los envían las entregas, para consultar periódicamente o usar como muestras. - name: Eventos de webhook description: >- Todos los eventos que pueden enviar los webhooks y los REST hooks, con la forma de sus datos. paths: /sales/orders/{order}/invoices: post: tags: - Pedidos de venta summary: Factura un pedido de venta description: >- Crea una factura en borrador de lo que se haya enviado del pedido y aún no se haya facturado. Si la organización factura antes de enviar, factura lo pedido. Los precios vienen del pedido y el impuesto de la tasa del cliente. Se rechaza cuando no queda nada por facturar. Requiere el permiso `sales.invoices.manage` y un token con `sales:write`. operationId: v1.sales.orders.invoice parameters: - name: order in: path required: true description: El ID del pedido de venta, un UUID. schema: type: string responses: '201': description: '`SalesInvoiceResource`' content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/SalesInvoiceResource' required: - data headers: X-RateLimit-Limit: description: >- Solicitudes por minuto permitidas para este token, o para la dirección si no tiene uno. schema: type: integer X-RateLimit-Remaining: description: Solicitudes que quedan este minuto. schema: type: integer '401': $ref: '#/components/responses/AuthenticationException' '403': $ref: '#/components/responses/AuthorizationException' '404': $ref: '#/components/responses/ModelNotFoundException' '422': $ref: '#/components/responses/ValidationException' '429': description: Demasiadas solicitudes content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' headers: Retry-After: description: Segundos hasta que se restablece el límite. schema: type: integer X-RateLimit-Limit: description: Solicitudes por minuto permitidas. schema: type: integer X-RateLimit-Remaining: description: 'Solicitudes que quedan este minuto: ninguna.' schema: type: integer x-codeSamples: - lang: typescript label: TypeScript SDK source: >- import { StockShift } from "@stockshift/sdk"; const stockshift = new StockShift({ token: process.env.STOCKSHIFT_TOKEN! }); const result = await stockshift.post("/sales/orders/{order}/invoices", { path: { order: "01J8QZ4M..." }, }); components: schemas: SalesInvoiceResource: type: object properties: id: type: string description: El ID de la factura, un UUID. number: type: string description: >- El número de factura, de la secuencia de la organización, como INV-00001. order_id: type: string description: El ID del pedido de venta que factura la factura. order_number: type: string description: El número del pedido de venta que factura la factura, como SO-00001. customer_id: type: string description: El ID del cliente al que se facturó. customer_code: type: string description: El código del cliente al que se facturó. customer_name: type: string description: El nombre del cliente al que se facturó. status: type: string description: >- En qué situación está la factura: `draft`, `issued`, `partially_paid`, `paid` o `void`. issued_on: type: string description: >- La fecha de emisión, como `YYYY-MM-DD`. Un borrador nuevo lleva la fecha del día en que se crea, y la fecha puede cambiar hasta que se emite la factura. due_on: type: string description: >- La fecha de vencimiento, como `YYYY-MM-DD`: la fecha de emisión más el plazo de pago del cliente. overdue: type: boolean description: >- Es true cuando la factura está emitida, no pagada por completo y vence antes de hoy. tax_rounding: type: string description: >- Dónde se redondea el impuesto al centavo: `per_line` o `per_invoice`, según lo tuviera definido la organización cuando se generó la factura. tax_exemption_reference: type: - string - 'null' description: >- La referencia de exención del cliente, copiada cuando se generó la factura. Es null cuando el cliente era sujeto a impuestos. tax_needs_recalculation: type: boolean description: >- Es true cuando la factura se gravó con la tasa propia del cliente porque el motor de impuestos conectado no respondió. Un borrador se puede volver a gravar. tax_partly_local: type: boolean description: >- Es true cuando algunas líneas, de artículos controlados, se gravaron en StockShift y nunca se enviaron al motor de impuestos. subtotal: type: string description: >- La suma de los totales de las líneas después de descuentos, antes de impuestos. tax: type: string description: El impuesto de cada línea. total: type: string description: El subtotal más el impuesto. paid: type: string description: La suma de los pagos registrados contra la factura. credited: type: string description: >- Lo que restaron del total las notas de crédito por productos devueltos. outstanding: type: string description: >- Lo que queda por pagar: el total menos `credited` y `paid`, nunca por debajo de 0. Es 0 una vez que la factura se anula. currency: type: string description: >- El código ISO 4217 de la moneda en la que está cada monto, que es la moneda de la organización. note: type: - string - 'null' description: Una nota impresa en la factura. Es null cuando no hay ninguna. issued_at: type: - string - 'null' description: >- Cuándo se emitió la factura, como marca de tiempo ISO 8601 en UTC. Es null mientras es un borrador. voided_at: type: - string - 'null' description: >- Cuándo se anuló la factura, como marca de tiempo ISO 8601 en UTC. Es null salvo que esté anulada. sent_at: type: - string - 'null' description: >- Cuándo se envió la factura por correo electrónico por última vez, como marca de tiempo ISO 8601 en UTC. Es null hasta que se envía. sent_to: type: - string - 'null' description: >- El contacto al que se envió por correo electrónico la factura por última vez, por nombre, o por correo electrónico cuando se borró el nombre. created_at: type: string description: Cuándo se generó la factura, como marca de tiempo ISO 8601 en UTC. lines: type: array description: Las líneas de la factura. Vacío en las listas. items: {} payments: type: array description: Los pagos registrados contra la factura. Está vacío en las listas. items: {} credit_notes: type: array description: >- Las más antiguas primero, con importes negativos: una por cada devolución que la acreditó, y la que la anuló. Vacío en las listas. items: {} required: - id - number - order_id - order_number - customer_id - customer_code - customer_name - status - issued_on - due_on - overdue - tax_rounding - tax_exemption_reference - tax_needs_recalculation - tax_partly_local - subtotal - tax - total - paid - credited - outstanding - currency - note - issued_at - voided_at - sent_at - sent_to - created_at - lines - payments - credit_notes title: SalesInvoiceResource description: >- Una factura a un cliente por un pedido de venta, con sus líneas, pagos y notas de crédito. Hay una nota de crédito por cada devolución de bienes que facturó, y una más cuando se anula. Los importes son decimales exactos en la moneda de la organización. ProblemDetails: type: object description: >- Un error, como detalles del problema RFC 9457. Decide según `code`, que es estable; `detail` está escrito para personas y puede cambiar. properties: type: type: string format: uri description: Enlaces a la documentación de este código. title: type: string description: El texto de estado HTTP. status: type: integer description: El código de estado HTTP. code: type: string description: Un nombre estable legible por máquina, como validation_failed. detail: type: string description: Qué salió mal, para las personas. errors: type: object description: >- Errores por campo. En validation_failed, y en un rechazo con un código propio como insufficient_stock o document_closed. additionalProperties: type: array items: type: string feature: type: string description: La función del plan que se necesita. Solo en plan_upgrade_required. reason: type: string description: >- Por qué un dispositivo debe descargar un feed de nuevo. Solo en resync_required. attempts_left: type: integer description: >- Cuántas firmas rechazadas quedan antes de que el miembro se bloquee en el dispositivo. Solo en signature_assertion_invalid. rule_ids: type: array description: >- Las reglas de testigo que cubren las existencias. Solo en verification_required. items: type: string witness: type: string description: >- Dónde firma el testigo: same_device, remote o either. Solo en verification_required. blind_recount: type: boolean description: >- Si el testigo vuelve a contar antes de ver la cantidad. Solo en verification_required. flags: type: array description: >- Las marcas que dejan abiertas las decisiones de una línea masiva, tal como las nombra la vista previa masiva. Solo en decision_required. items: type: object properties: flag: type: string description: El nombre de la marca, tal como lo da la vista previa masiva. facts: type: object description: >- Los hechos de la marca, como en la vista previa masiva; los demás son null. additionalProperties: anyOf: - type: string - type: integer - type: array items: type: string - type: 'null' choices: type: array description: >- Las decisiones que resolverían la marca, tal como las nombra la vista previa masiva. items: type: string required: - flag - facts - choices required: - type - title - status - code - detail title: ProblemDetails responses: AuthenticationException: description: No autenticado content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' AuthorizationException: description: Prohibido content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' ModelNotFoundException: description: No encontrado content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' ValidationException: description: Error de validación content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' securitySchemes: apiKey: type: http description: >- Para tus propios scripts e integraciones de servidor a servidor. Crea una clave en la app en Configuración > Acceso > Claves de API y cópiala entonces, porque se muestra una sola vez. Envíala como `Authorization: Bearer `. La clave actúa como el miembro que la creó, en la organización en la que se creó. Una llamada necesita el permiso del miembro y uno de los alcances de la clave, como `inventory:read` o `sales:write`. Una clave con `*` tiene todos los alcances. scheme: bearer oauth2: type: oauth2 description: >- Para apps que otras personas conectan a su cuenta de StockShift. Usa el flujo de código de autorización OAuth 2.1 con PKCE (S256); no hay secreto de cliente. Descubre los endpoints en `/.well-known/oauth-authorization-server` (RFC 8414) y registra tu app en `POST /oauth/register` (RFC 7591). El miembro elige la organización y aprueba los alcances en la página de consentimiento, y el token nunca puede hacer más de lo que podría hacer el miembro. Envíalo como `Authorization: Bearer `, igual que una clave de API. Los tokens de acceso duran una hora; cada actualización devuelve un token de actualización nuevo, así que guárdalo. flows: authorizationCode: authorizationUrl: https://app.stockshift.io/oauth/authorize tokenUrl: https://app.stockshift.io/oauth/token refreshUrl: https://app.stockshift.io/oauth/token scopes: access:read: Access read audit:read: Audit read address:read: Address read address:write: Address write billing:read: Billing read catalog:read: Catalog read catalog:write: Catalog write dashboard:read: Dashboard read dashboard:write: Dashboard write developer:read: Developer read developer:write: Developer write devices:read: Devices read devices:write: Devices write documents:read: Documents read documents:write: Documents write notifications:read: Notifications read notifications:write: Notifications write inventory:read: Inventory read inventory:write: Inventory write purchasing:read: Purchasing read purchasing:write: Purchasing write quality:read: Quality read quality:write: Quality write sales:read: Sales read sales:write: Sales write engineering:read: Engineering read engineering:write: Engineering write manufacturing:read: Manufacturing read manufacturing:write: Manufacturing write automation:read: Automation read automation:write: Automation write insights:read: Insights read insights:write: Insights write integrations:read: Integrations read integrations:write: Integrations write labels:read: Labels read labels:write: Labels write library:read: Library read organization:read: Organization read organization:write: Organization write planning:read: Planning read planning:write: Planning write sync:read: Sync read sync:write: Sync write ```` ## Related topics - [Obtén un pedido de venta](https://docs.stockshift.io/es/api-reference/pedidos-de-venta/obtén-un-pedido-de-venta.md) - [Cancela un pedido de venta](https://docs.stockshift.io/es/api-reference/pedidos-de-venta/cancela-un-pedido-de-venta.md) - [Confirma un pedido de venta](https://docs.stockshift.io/es/api-reference/pedidos-de-venta/confirma-un-pedido-de-venta.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.