Operaciones masivas

Miles de registros en una solicitud: fijar stock, escribir productos, exportar pedidos. El resultado es NDJSON, una línea por entrada, descargable por rangos.

Cargando el índice de búsqueda…

Operaciones masivas

Objetos

BulkOperation

  • idintegerobligatorio

    ID del registro, único entre los registros de su tipo en la tienda.

  • app_idintegerobligatorio

    ID de la aplicación que creó la operación.

  • typestringobligatorio

    Tipo de operación: inventory.set — fijar el stock; products.upsert — crear o actualizar productos con variantes; money_transactions.create — ingresos y gastos manuales; money_transactions.update — editar movimientos de dinero, por ejemplo asignar categorías; orders.export — exportar pedidos; libro_iva.export — los libros del Libro IVA Digital de una razón social para un mes; accountant_package.export — el paquete del contador de una razón social para un mes.

    Valores:
    inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
  • statusstringobligatorio

    pending — espera para iniciar; running — en curso; cancelling — se detiene después de la línea actual; completed — se procesó toda la entrada o se generó el archivo; cancelled — cancelada; failed — se detuvo antes del final de la entrada o no generó el archivo (error).

    Valores:
    pendingrunningcancellingcompletedcancelledfailed
  • inputobject o nullobligatorio

    La entrada de la operación: una carga por partes o una dirección. null en una exportación y en un archivo: no tienen entrada.

    Campos · 5
    • sourcestringobligatorio

      upload — una carga por partes (/v1/uploads); url — un archivo descargado desde una dirección.

      Valores:
      uploadurl
    • urlstring o nullobligatorio

      Dirección desde la que se descarga la entrada; null en una carga.

    • file_namestring o nullobligatorio

      Nombre del archivo cargado; null en una dirección.

    • bytesinteger o nullobligatorio

      Tamaño de la entrada en bytes, descomprimida si llegó en gzip; null mientras se desconoce.

    • processed_bytesintegerobligatorio

      Cuántos bytes de la entrada se procesaron: su proporción es el avance.

  • paramsobject o nullobligatorio

    Parámetros de la exportación o del archivo tal como los aceptó la creación: en orders.export, los filtros del listado GET /v1/orders (updated_since, number); en libro_iva.export, legal_entity_id, period y books; en accountant_package.export, legal_entity_id y period. null en una operación con entrada.

  • linesobjectobligatorio

    Líneas de la entrada: leídas (incluidas las vacías), ejecutadas con éxito y rechazadas. Una línea rechazada no detiene la operación; su motivo está en el resultado. En una exportación, los elementos del listado escritos en el resultado: read y succeeded son iguales, failed es 0. En un archivo, ceros: su resultado es status y su contenido es el archivo comprimido.

    Campos · 3
    • readintegerobligatorio

      Líneas leídas.

    • succeededintegerobligatorio

      Líneas procesadas con éxito.

    • failedintegerobligatorio

      Líneas rechazadas.

  • errorobject o nullobligatorio

    En failed, por qué la operación no llegó al final de la entrada o no generó el archivo. En una en curso, la última falla de descarga de la entrada que todavía se reintenta. Si no, null.

    Campos · 4
    • codestringobligatorio

      invalid_url, blocked_address, unreachable, too_large, access_denied, not_found, rate_limited, http_error — la entrada no se descargó (source_status ante una respuesta con error de su servidor); input_corrupt — la entrada no se puede leer, por ejemplo un gzip roto; app_unavailable — la aplicación se eliminó o perdió el acceso; scope_revoked — la aplicación perdió un scope que la operación necesita; capability_disabled — la tienda ya no tiene el libro fiscal que contiene los datos del archivo; locations_restricted — la aplicación quedó limitada a algunos locales y el archivo abarca toda la razón social; legal_entity_deleted — la razón social se eliminó después de crear la operación; libro_iva_not_applicable — la razón social no lleva el Libro IVA Digital; libro_iva_incomplete — hay comprobantes del período que no se pueden describir como registros del libro (documents); processing_failed — una falla interna.

      Valores:
      invalid_urlblocked_addressunreachabletoo_largeaccess_deniednot_foundrate_limitedhttp_errorinput_corruptapp_unavailablescope_revokedprocessing_failedcapability_disabledlocations_restrictedlegal_entity_deletedlibro_iva_not_applicablelibro_iva_incomplete
    • messagestringobligatorio

      El motivo en palabras, en el idioma de la solicitud.

    • source_statusinteger o nullobligatorio

      Estado HTTP con el que respondió el servidor de la entrada, en access_denied, not_found, rate_limited y http_error; si no, null.

    • documentsarray de object o nullobligatorio

      En libro_iva_incomplete, los comprobantes del período que no se pueden describir como registros del libro; corregilos en la tienda y creá la operación de nuevo. Si no, null.

      Campos · 3
      • typestringobligatorio

        fiscal_document — un comprobante fiscal del libro de ventas; supplier_bill — un comprobante de proveedor del libro de compras o de importación.

        Valores:
        fiscal_documentsupplier_bill
      • idintegerobligatorio

        ID del registro, único entre los registros de su tipo en la tienda.

      • reasonstringobligatorio

        Por qué no se puede describir: missing_request, missing_number — el comprobante fiscal no tiene la solicitud a ARCA o el número; unknown_document_type, other_ledger_file, broker_fields_required — el tipo de comprobante no corresponde a este libro o faltan los datos del corredor; currency_code_unconfirmed, unsupported_currency, missing_exchange_rate — la moneda no tiene código de ARCA o no tiene cotización; invalid_vendor_tax_id — CUIT del vendedor inválido; unknown_tax_rate — la alícuota no se puede desglosar; missing_despacho, unknown_rate — una importación de bienes no tiene número de despacho o alícuota; missing_import_document_kind, missing_import_document_description, unsupported_service_rate, missing_import_tax_payment — a una importación de servicios le falta el comprobante del prestador, la alícuota o el pago del impuesto.

        Valores:
        missing_requestmissing_numberunknown_document_typeother_ledger_filebroker_fields_requiredcurrency_code_unconfirmedunsupported_currencymissing_exchange_rateinvalid_vendor_tax_idunknown_tax_ratemissing_despachounknown_ratemissing_import_document_kindmissing_import_document_descriptionunsupported_service_ratemissing_import_tax_payment
  • result_urlstringobligatorio

    La dirección del resultado: NDJSON, una línea por cada línea de la entrada en orden, con los resultados de las líneas ya procesadas; en una exportación, un elemento del listado por línea; en un archivo, el ZIP de la operación terminada. Se puede reanudar por rangos.

  • result_scopesarray de stringobligatorio

    Scopes que necesita el resultado: la lectura de los datos del tipo y los scopes de campos con los que se creó la operación, como customers:read en una exportación de pedidos con datos de clientes. El conjunto se fija al crearla; quitar un scope detiene la operación (scope_revoked).

  • sync_cursorstring o nullobligatorio

    En una exportación completada — el cursor de sincronización del listado del que se armó (GET /v1/orders con los mismos params): con él el listado devuelve lo que cambió después de la exportación. Si no, null.

  • created_atstring (date-time)obligatorio

    Cuándo se creó el registro.

  • updated_atstring (date-time)obligatorio

    Cuándo cambió el registro por última vez.

  • started_atstring (date-time) o nullobligatorio

    Cuándo empezó la operación; null mientras está en pending.

  • finished_atstring (date-time) o nullobligatorio

    Cuándo terminó la operación; null hasta entonces.

Endpoints

Listar las operaciones masivas de la app cambiadas desde un momento dado: avance y resultados

get/bulk-operations

Scope: bulk:read

Parámetros

Query

  • limitinteger

    Tamaño de página: hasta 250 registros; 50 por defecto.

    Mínimo:
    1
    Máximo:
    250
  • cursorstring

    Cursor opaco: next_cursor de la página anterior, o sync_cursor de la última página guardado por la sincronización anterior. El listado va en orden de confirmación, así que el cursor de sincronización devuelve luego solo lo que cambió después de él.

    Largo máximo:
    4096
  • updated_sincestring (date-time)

    Solo los registros cambiados después de este momento, ISO 8601 con zona horaria. Un filtro de la primera sincronización; después se sigue con el cursor.

    Patrón:
    ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
  • typestring

    Solo las operaciones de este tipo.

    Valores:
    inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
  • statusstring

    Solo las operaciones en este estado.

    Valores:
    pendingrunningcancellingcompletedcancelledfailed

Respuestas

200Éxito

application/json

  • dataarray de BulkOperationobligatorio

    Registros de la página.

  • deletedarray de objectobligatorio

    Registros borrados de la base desde el cursor, como marcas de eliminación: solo con include_deleted=true en la continuación por el cursor de sincronización.

    Campos · 2
    • idintegerobligatorio

      ID del registro borrado.

    • deleted_atstring (date-time)obligatorio

      Cuándo se borró el registro.

  • next_cursorstring o nullobligatorio

    Cursor de la página siguiente; null en la última.

  • has_morebooleanobligatorio

    true si hay una página siguiente.

  • sync_cursorstring o nullobligatorio

    En la última página — el cursor desde el que continuar más tarde: con él llega solo lo que cambió después de esta página. null en las demás.

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

410El cursor de sincronización supera el plazo de conservación de eliminaciones o se emitió antes de restaurar la base de datos

application/problem+json

Devuelve Problem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Errores de este endpoint

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl "https://api.saleya.app/v1/bulk-operations" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "data": [
    {
      "id": 0,
      "app_id": 0,
      "type": "inventory.set",
      "status": "pending",
      "input": {
        "source": "upload",
        "url": "string",
        "file_name": "string",
        "bytes": 0,
        "processed_bytes": 0
      },
      "params": {},
      "lines": {
        "read": 0,
        "succeeded": 0,
        "failed": 0
      },
      "error": {
        "code": "invalid_url",
        "message": "string",
        "source_status": 0,
        "documents": [
          {
            "type": "fiscal_document",
            "id": 0,
            "reason": "missing_request"
          }
        ]
      },
      "result_url": "string",
      "result_scopes": [
        "string"
      ],
      "sync_cursor": "string",
      "created_at": "2026-01-15T12:00:00Z",
      "updated_at": "2026-01-15T12:00:00Z",
      "started_at": "2026-01-15T12:00:00Z",
      "finished_at": "2026-01-15T12:00:00Z"
    }
  ],
  "deleted": [
    {
      "id": 0,
      "deleted_at": "2026-01-15T12:00:00Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true,
  "sync_cursor": "string"
}

Iniciar una operación masiva desde una carga o una dirección de entrada, una exportación del listado o la generación de un archivo

post/bulk-operations

Scope: bulk:write

Parámetros

Encabezado

  • Idempotency-Keystring

    Clave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.

    Largo mínimo:
    1
    Largo máximo:
    255
    Ejemplo:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Cuerpo de la solicitud application/json

  • typestringobligatorio

    Tipo de operación: inventory.set — fijar el stock; products.upsert — crear o actualizar productos con variantes; money_transactions.create — ingresos y gastos manuales; money_transactions.update — editar movimientos de dinero, por ejemplo asignar categorías; orders.export — exportar pedidos; libro_iva.export — los libros del Libro IVA Digital de una razón social para un mes; accountant_package.export — el paquete del contador de una razón social para un mes.

    Valores:
    inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
  • inputobject

    La entrada de la operación: una carga por partes o una dirección. null en una exportación y en un archivo: no tienen entrada.

    Campos · 2
    • upload_idinteger

      ID de una carga por partes ya armada (/v1/uploads).

      Mínimo:
      1
    • urlstring

      Dirección desde la que se descarga la entrada; null en una carga.

      Largo máximo:
      2048
  • paramsobject

    Parámetros de la exportación o del archivo tal como los aceptó la creación: en orders.export, los filtros del listado GET /v1/orders (updated_since, number); en libro_iva.export, legal_entity_id, period y books; en accountant_package.export, legal_entity_id y period. null en una operación con entrada.

    Campos · 6
    • updated_sincestring (date-time)

      En orders.export — los pedidos cambiados después de este momento.

      Patrón:
      ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,6})?(Z|[+-]\d{2}:\d{2})$
    • include_deletedboolean

      En orders.export — también los pedidos eliminados.

    • numberstring

      En orders.export — solo el pedido con este número.

      Largo máximo:
      16
    • legal_entity_idinteger

      En libro_iva.export y accountant_package.export: la razón social cuyo archivo se genera.

    • periodstring

      En libro_iva.export y accountant_package.export: el mes con formato YYYY-MM, no posterior al mes actual de la tienda.

    • booksarray de string

      En libro_iva.export: los libros, ventas y compras (las compras con los archivos de importación), uno o ambos.

      Mínimo de elementos:
      1
      Máximo de elementos:
      2
      Sin repetidos
      Valores:
      ventascompras

Respuestas

202Aceptado: el resultado está en la dirección de Location

Encabezados

  • Idempotent-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true
  • Locationstring (uri)obligatorio

    Dirección del registro creado; en una solicitud aceptada (202), la dirección donde seguir su resultado.

application/json

Devuelve BulkOperation

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve ConflictProblem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Errores de este endpoint

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/bulk-operations" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d @body.json
Cuerpo de la solicitud — body.json
{
  "type": "inventory.set",
  "input": {
    "upload_id": 1,
    "url": "string"
  },
  "params": {
    "updated_since": "2026-01-15T12:00:00Z",
    "include_deleted": true,
    "number": "string",
    "legal_entity_id": 0,
    "period": "string",
    "books": [
      "ventas"
    ]
  }
}
Ejemplo de respuesta · 202
{
  "id": 0,
  "app_id": 0,
  "type": "inventory.set",
  "status": "pending",
  "input": {
    "source": "upload",
    "url": "string",
    "file_name": "string",
    "bytes": 0,
    "processed_bytes": 0
  },
  "params": {},
  "lines": {
    "read": 0,
    "succeeded": 0,
    "failed": 0
  },
  "error": {
    "code": "invalid_url",
    "message": "string",
    "source_status": 0,
    "documents": [
      {
        "type": "fiscal_document",
        "id": 0,
        "reason": "missing_request"
      }
    ]
  },
  "result_url": "string",
  "result_scopes": [
    "string"
  ],
  "sync_cursor": "string",
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z",
  "started_at": "2026-01-15T12:00:00Z",
  "finished_at": "2026-01-15T12:00:00Z"
}

Obtener una operación masiva

get/bulk-operations/{operation}

Scope: bulk:read

Parámetros

Ruta

  • operationintegerobligatorio

    ID de la operación masiva.

Respuestas

200Éxito

application/json

Devuelve BulkOperation

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

404El objeto no existe o no está disponible para la aplicación

application/problem+json

Devuelve Problem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl "https://api.saleya.app/v1/bulk-operations/{operation}" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "id": 0,
  "app_id": 0,
  "type": "inventory.set",
  "status": "pending",
  "input": {
    "source": "upload",
    "url": "string",
    "file_name": "string",
    "bytes": 0,
    "processed_bytes": 0
  },
  "params": {},
  "lines": {
    "read": 0,
    "succeeded": 0,
    "failed": 0
  },
  "error": {
    "code": "invalid_url",
    "message": "string",
    "source_status": 0,
    "documents": [
      {
        "type": "fiscal_document",
        "id": 0,
        "reason": "missing_request"
      }
    ]
  },
  "result_url": "string",
  "result_scopes": [
    "string"
  ],
  "sync_cursor": "string",
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z",
  "started_at": "2026-01-15T12:00:00Z",
  "finished_at": "2026-01-15T12:00:00Z"
}

Obtener el resultado de una operación masiva: NDJSON, una línea por línea de entrada o por elemento exportado, o el ZIP de una operación de archivo; se reanuda con Range

get/bulk-operations/{operation}/result

Scope: bulk:read

Parámetros

Ruta

  • operationintegerobligatorio

    ID de la operación masiva.

Encabezado

  • Rangestring

    Un rango de bytes para reanudar la descarga: bytes=<desde>- o bytes=<desde>-<hasta>. El resultado de una operación en curso solo crece: seguí con bytes=<descargado>- sin If-Range; 416 significa que todavía no hay líneas nuevas. Varios rangos reciben el resultado entero.

    Ejemplo:
    bytes=1048576-
  • If-Rangestring

    ETag del resultado de la respuesta anterior. El rango se entrega solo si desde entonces no se agregó nada; si no, el resultado entero (200).

    Ejemplo:
    "52428800"

Respuestas

200Éxito

Encabezados

  • Accept-Rangesstring

    bytes: el resultado se entrega por rangos. Una respuesta comprimida (Content-Encoding: gzip) no trae este encabezado: no se puede reanudar.

    Valores:
    bytes
  • ETagstringobligatorio

    Etiqueta del resultado, distinta cada vez que el resultado crece. Mandala en If-Range para reanudar la misma versión. Una respuesta comprimida trae una etiqueta débil (W/) que no sirve en If-Range.

    Ejemplo:
    "52428800"

application/x-ndjson

object o Order

Variante 1: object

  • lineintegerobligatorio

    Número de la línea de la entrada, desde 1.

  • statusintegerobligatorio

    Estado HTTP que la línea obtendría como solicitud separada.

  • bodyobjectobligatorio

    Respuesta a la línea: el registro tal como lo devuelve su endpoint, o un rechazo problem+json.

application/zip

string (binary)

206Parte del resultado por Range

Encabezados

  • Accept-Rangesstring

    bytes: el resultado se entrega por rangos. Una respuesta comprimida (Content-Encoding: gzip) no trae este encabezado: no se puede reanudar.

    Valores:
    bytes
  • ETagstringobligatorio

    Etiqueta del resultado, distinta cada vez que el resultado crece. Mandala en If-Range para reanudar la misma versión. Una respuesta comprimida trae una etiqueta débil (W/) que no sirve en If-Range.

    Ejemplo:
    "52428800"
  • Content-Rangestringobligatorio

    El rango entregado y la longitud escrita: bytes 0-1023/52428800; en 416, bytes */52428800.

    Ejemplo:
    bytes 1048576-52428799/52428800

application/x-ndjson

object o Order

Variante 1: object

  • lineintegerobligatorio

    Número de la línea de la entrada, desde 1.

  • statusintegerobligatorio

    Estado HTTP que la línea obtendría como solicitud separada.

  • bodyobjectobligatorio

    Respuesta a la línea: el registro tal como lo devuelve su endpoint, o un rechazo problem+json.

application/zip

string (binary)

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

404El objeto no existe o no está disponible para la aplicación

application/problem+json

Devuelve Problem

409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve ConflictProblem

416El rango empieza después del resultado escrito

Encabezados

  • Content-Rangestringobligatorio

    El rango entregado y la longitud escrita: bytes 0-1023/52428800; en 416, bytes */52428800.

    Ejemplo:
    bytes 1048576-52428799/52428800

application/problem+json

Devuelve Problem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Errores de este endpoint

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl "https://api.saleya.app/v1/bulk-operations/{operation}/result" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"

Cancelar una operación masiva en el límite de una línea

post/bulk-operations/{operation}/cancel

Scope: bulk:write

Parámetros

Ruta

  • operationintegerobligatorio

    ID de la operación masiva.

Encabezado

  • Idempotency-Keystring

    Clave única del intento, por ejemplo un UUID. Un reintento con la misma clave y el mismo cuerpo recibe la respuesta guardada en vez de escribir dos veces. Las claves duran 24 horas.

    Largo mínimo:
    1
    Largo máximo:
    255
    Ejemplo:
    8e03978e-40d5-43e8-bc93-6894a57f9324

Respuestas

200Éxito

Encabezados

  • Idempotent-Replayedstring

    true cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.

    Valores:
    true

application/json

Devuelve BulkOperation

401Falta el token, es inválido, venció o fue revocado

Encabezados

  • WWW-Authenticatestringobligatorio

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer

application/problem+json

Devuelve Problem

403El plan, la dirección IP o los scopes del token no permiten la solicitud

Encabezados

  • WWW-Authenticatestring

    Esquema de autenticación (RFC 6750).

    Ejemplo:
    Bearer error="insufficient_scope", scope="locations:read"

application/problem+json

Devuelve ForbiddenProblem

404El objeto no existe o no está disponible para la aplicación

application/problem+json

Devuelve Problem

409Hay una solicitud en curso con la misma clave de idempotencia, los datos cambiaron después de leerlos, el ID externo pertenece a otro registro, se alcanzó el límite del plan o de endpoints de webhook, o el cambio necesita consentir sus consecuencias

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve ConflictProblem

422Un parámetro es inválido o desconocido

application/problem+json

Devuelve ValidationProblem

429Se agotó el límite de solicitudes

Encabezados

  • Retry-Afterintegerobligatorio

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve RateLimitProblem

503La tienda no está disponible por ahora

Encabezados

  • Retry-Afterinteger

    Segundos de espera antes de reintentar.

    Mínimo:
    0

application/problem+json

Devuelve Problem

Errores de este endpoint

Los errores comunes, como token, acceso, validación de la entrada y límite de solicitudes, pueden venir de cualquier endpoint; están en el catálogo: Errores

Ejemplo de solicitud
curl -X POST "https://api.saleya.app/v1/bulk-operations/{operation}/cancel" \
  -H "Authorization: Bearer $SALEYA_API_TOKEN"
Ejemplo de respuesta · 200
{
  "id": 0,
  "app_id": 0,
  "type": "inventory.set",
  "status": "pending",
  "input": {
    "source": "upload",
    "url": "string",
    "file_name": "string",
    "bytes": 0,
    "processed_bytes": 0
  },
  "params": {},
  "lines": {
    "read": 0,
    "succeeded": 0,
    "failed": 0
  },
  "error": {
    "code": "invalid_url",
    "message": "string",
    "source_status": 0,
    "documents": [
      {
        "type": "fiscal_document",
        "id": 0,
        "reason": "missing_request"
      }
    ]
  },
  "result_url": "string",
  "result_scopes": [
    "string"
  ],
  "sync_cursor": "string",
  "created_at": "2026-01-15T12:00:00Z",
  "updated_at": "2026-01-15T12:00:00Z",
  "started_at": "2026-01-15T12:00:00Z",
  "finished_at": "2026-01-15T12:00:00Z"
}