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.
Operaciones masivas
Objetos
BulkOperation
idintegerobligatorioID del registro, único entre los registros de su tipo en la tienda.
app_idintegerobligatorioID de la aplicación que creó la operación.
typestringobligatorioTipo 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
statusstringobligatoriopending — 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 nullobligatorioLa 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
sourcestringobligatorioupload — una carga por partes (/v1/uploads); url — un archivo descargado desde una dirección.
- Valores:
uploadurl
urlstring o nullobligatorioDirección desde la que se descarga la entrada; null en una carga.
file_namestring o nullobligatorioNombre del archivo cargado; null en una dirección.
bytesinteger o nullobligatorioTamaño de la entrada en bytes, descomprimida si llegó en gzip; null mientras se desconoce.
processed_bytesintegerobligatorioCuántos bytes de la entrada se procesaron: su proporción es el avance.
paramsobject o nullobligatorioPará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.
linesobjectobligatorioLí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
readintegerobligatorioLíneas leídas.
succeededintegerobligatorioLíneas procesadas con éxito.
failedintegerobligatorioLíneas rechazadas.
errorobject o nullobligatorioEn 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
codestringobligatorioinvalid_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
messagestringobligatorioEl motivo en palabras, en el idioma de la solicitud.
source_statusinteger o nullobligatorioEstado 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 nullobligatorioEn 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
typestringobligatoriofiscal_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
idintegerobligatorioID del registro, único entre los registros de su tipo en la tienda.
reasonstringobligatorioPor 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_urlstringobligatorioLa 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 stringobligatorioScopes 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 nullobligatorioEn 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)obligatorioCuándo se creó el registro.
updated_atstring (date-time)obligatorioCuándo cambió el registro por última vez.
started_atstring (date-time) o nullobligatorioCuándo empezó la operación; null mientras está en pending.
finished_atstring (date-time) o nullobligatorioCuá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
limitintegerTamaño de página: hasta 250 registros; 50 por defecto.
- Mínimo:
- 1
- Máximo:
- 250
cursorstringCursor 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})$
typestringSolo las operaciones de este tipo.
- Valores:
inventory.setproducts.upsertmoney_transactions.createmoney_transactions.updateorders.exportlibro_iva.exportaccountant_package.export
statusstringSolo las operaciones en este estado.
- Valores:
pendingrunningcancellingcompletedcancelledfailed
Respuestas
200Éxito
application/json
Registros de la página.
deletedarray de objectobligatorioRegistros 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
idintegerobligatorioID del registro borrado.
deleted_atstring (date-time)obligatorioCuándo se borró el registro.
next_cursorstring o nullobligatorioCursor de la página siguiente; null en la última.
has_morebooleanobligatoriotrue si hay una página siguiente.
sync_cursorstring o nullobligatorioEn 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-AuthenticatestringobligatorioEsquema 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-AuthenticatestringEsquema 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-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos 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
curl "https://api.saleya.app/v1/bulk-operations" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"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-KeystringClave ú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
typestringobligatorioTipo 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
inputobjectLa 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_idintegerID de una carga por partes ya armada (/v1/uploads).
- Mínimo:
- 1
urlstringDirección desde la que se descarga la entrada; null en una carga.
- Largo máximo:
- 2048
paramsobjectPará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_deletedbooleanEn orders.export — también los pedidos eliminados.
numberstringEn orders.export — solo el pedido con este número.
- Largo máximo:
- 16
legal_entity_idintegerEn libro_iva.export y accountant_package.export: la razón social cuyo archivo se genera.
periodstringEn libro_iva.export y accountant_package.export: el mes con formato YYYY-MM, no posterior al mes actual de la tienda.
booksarray de stringEn 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-Replayedstringtrue cuando es la respuesta guardada de una solicitud anterior con el mismo Idempotency-Key.
- Valores:
true
Locationstring (uri)obligatorioDirecció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-AuthenticatestringobligatorioEsquema 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-AuthenticatestringEsquema 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-AfterintegerSegundos 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-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 403
capability_disabledRecurso no disponible para esta tienda - 409
bulk_operation_queue_fullLa cola de operaciones de la app está llena - 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida
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
curl -X POST "https://api.saleya.app/v1/bulk-operations" \
-H "Authorization: Bearer $SALEYA_API_TOKEN" \
-H "Content-Type: application/json" \
-d @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"
]
}
}{
"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
operationintegerobligatorioID de la operación masiva.
Respuestas
200Éxito
application/json
Devuelve BulkOperation
401Falta el token, es inválido, venció o fue revocado
Encabezados
WWW-AuthenticatestringobligatorioEsquema 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-AuthenticatestringEsquema 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-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos 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
curl "https://api.saleya.app/v1/bulk-operations/{operation}" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"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
operationintegerobligatorioID de la operación masiva.
Encabezado
RangestringUn 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-RangestringETag 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-Rangesstringbytes: el resultado se entrega por rangos. Una respuesta comprimida (Content-Encoding: gzip) no trae este encabezado: no se puede reanudar.
- Valores:
bytes
ETagstringobligatorioEtiqueta 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
lineintegerobligatorioNúmero de la línea de la entrada, desde 1.
statusintegerobligatorioEstado HTTP que la línea obtendría como solicitud separada.
bodyobjectobligatorioRespuesta 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-Rangesstringbytes: el resultado se entrega por rangos. Una respuesta comprimida (Content-Encoding: gzip) no trae este encabezado: no se puede reanudar.
- Valores:
bytes
ETagstringobligatorioEtiqueta 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-RangestringobligatorioEl 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
lineintegerobligatorioNúmero de la línea de la entrada, desde 1.
statusintegerobligatorioEstado HTTP que la línea obtendría como solicitud separada.
bodyobjectobligatorioRespuesta 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-AuthenticatestringobligatorioEsquema 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-AuthenticatestringEsquema 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-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve ConflictProblem
416El rango empieza después del resultado escrito
Encabezados
Content-RangestringobligatorioEl 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-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
bulk_operation_result_unavailableNo hay archivo de resultado - 416
range_not_satisfiableEl rango empieza después del resultado
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
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
operationintegerobligatorioID de la operación masiva.
Encabezado
Idempotency-KeystringClave ú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-Replayedstringtrue 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-AuthenticatestringobligatorioEsquema 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-AuthenticatestringEsquema 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-AfterintegerSegundos 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-AfterintegerobligatorioSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve RateLimitProblem
503La tienda no está disponible por ahora
Encabezados
Retry-AfterintegerSegundos de espera antes de reintentar.
- Mínimo:
- 0
application/problem+json
Devuelve Problem
Errores de este endpoint
- 409
bulk_operation_finishedLa operación ya terminó - 409
idempotency_key_in_useHay una solicitud en curso con esta clave - 422
idempotency_key_reusedLa clave de idempotencia ya se usó - 422
invalid_idempotency_keyLa clave de idempotencia no es válida
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
curl -X POST "https://api.saleya.app/v1/bulk-operations/{operation}/cancel" \
-H "Authorization: Bearer $SALEYA_API_TOKEN"{
"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"
}