Skip to main content

Preguntas frecuentes

⚠️ Errores

Todos los mensajes de error entregan un código de error y un mensaje descriptivo del error.

Códigos de error http

CódigoDescripción
400Bad RequestPetición inválida
401UnauthorizedAccess Token incorrecto
402Payment Required Instancia bloqueada por no pago
403ForbiddenNo tiene autorización para acceder al recurso solicitado
404Not Found Recurso solicitado no pudo ser encontrado
405Method Not AllowedEl método o acción solicitada no está permitida en el recurso
429Too Many RequestsLa solicitud no fue aceptada porque la solicitud ha excedido el límite (3.000 request x 300 segundos)
500Internal Server ErrorOcurrió un error no esperado en el servidor que procesa la petición
502Unknown ErrorUn error no manejado por la API

Mensajes de error

400

Invalid variant
Descripción: Verifica la variante del detalle, estado, espacios o guiones están correctamente enviados.
Respuesta:

"error": invalid variant"

The json does not have reference document
Descripción: Verifica la estructura JSON, si estás generando una devolución, ésta debe tener una referencia.
Respuesta: "error": "the json does not have reference document"
Invalid variant
Descripción: Verifica la(s) variante(s) que se envian, ej su estado, espacios, guiones o la variante es posible que la variante no exista
Respuesta: "error": invalid variant"
The json does not have reference document
Descripción: Verifica la referencia usada
Respuesta: "error": "the json does not have reference document"
Invalid reference detail
Descripción: Verifica la referencia del documento a nivel del detalle debe ser un id válido
Respuesta: "error": "invalid reference detail"
Invalid documentType
Descripción: Verifica el documentType que esté activo. Valida que estás apuntando al recurso correcto (devoluciones a returns.json / ventas a documents.json etc)
Respuesta: "error": "invalid documentType"
Invalid net unit value, zero or negative values are not allowed for this type of document
Descripción: Verifica los valores en los netos, si necesitas generar una línea con valor 0, indica un 100% descuento a la línea
Respuesta: "error": "Invalid net unit value, zero or negative values are not allowed for this type of document"
Sorry, this request can not be authenticated
Descripción: Verifica el token de acceso utilizado en la petición
Respuesta: "error":"Sorry, this request can not be authenticated"
No implicit conversion of String into Integer
Descripción: Verifica la estructura JSON, respeta nodos y arreglos según corresponda
Respuesta: "error": "no implicit conversion of String into Integer"
Invalid price list
Descripción: Verifica la lista de precios que estas referenciando, debe existir y tener estado activo.
Respuesta: "error": "invalid price list"
"code" is out of range for ActiveRecord::Type::Integer with limit
Descripción: Verifica que el code que estás usando exista en Bsale o tenga estado 0
Respuesta: "error":""code" is out of range for ActiveRecord::Type::Integer with limit 4"
Invalid pack promo detail
Descripción: Verifica que el pack promoción esté asociado por variantes. Valida que el code del pack exista.
Respuesta: "error":"invalid pack promo detail"
Client attribute required : code,activity,address,city,municipality
Descripción: Verifica los datos de cliente. En caso que no necesitar estos datos, colocate en contacto con ayuda@bsale.app
Respuesta: "error":"client attribute required : code,activity,address,city,municipality"
The amount is higher than deposit available
Descripción: Verifica el monto pagado sea mayor o igual a la deuda
Respuesta: "error": "the amount is higher than deposit available"
Does not have numbers available, check sii caf
Descripción: Verifica los folios electrónicos, en caso de ser necesario cargar nuevos
Respuesta: "error": "does not have numbers available, check sii caf"
The quantity returned (1.0) is higher than the available (0.0) for detail: "id detalle"
Descripción: Verifica la cantidad de la devolución. Valida que no tenga generada una devolución a la misma venta.
Respuesta: "error": "The quantity returned (1.0) is higher than the available (0.0) for detail: "id detalle""
This document may not be removed because it was used
Descripción: Verifica que el documento de referencia esté con estado activo
Respuesta: "error": "This document may not be removed because it was used"
There is a problem with the available quantity for your products
Descripción: Verifica la cantidad de stock
Respuesta: "error": "There is a problem with the available quantity for your products"
There are more than a client with the code "code", client id: "clientId"
Descripción: Verifica que no exista un cliente con el mismo rut / mail
Respuesta: "error": "There are more than a client with the code "code", client id: "clientId""
Invalid exchange rate
Descripción: Verifica la lista de precios enviada (priceListId) o la asignada por defecto a la sucursal en caso de no enviar.
Respuesta: "error":"invalid exchange rate"
Invalid quantity
Descripción: Verifica que respetas la estructura de envío en el detalle (corchetes y comas)
Respuesta: "error": "invalid quantity"
Invalid JSON object
Descripción: Verifica que estás cerrando con coma (,) y comillas (") cada atributos que lo requiera
Respuesta: "error": "Invalid JSON object"
The return already been nullified
Descripción: Verifica que la devolución esté disponible a anular
Respuesta: "error": "the return already been nullified"
Unavailable document number
Descripción: Verifica el folio del documento. Contacta a soporte ayuda@bsale.app
Respuesta: "error": "unavailable document number"
Price list not found
Descripción: Verifica el priceListId enviado en tu json, valida que este activo
Respuesta: "error": "price list not found"
the number of details allowed for this document is "número"
Descripción: Verifica la configuración del tipo de documento, cada tipo de documento se configura según sus necesidades
Respuesta: "error": "the number of details allowed for this document is "número""
The client is required for this type of document if the amount is greater than or equal 10.0
Descripción: Verifica la configuración del tipo de documento, cada tipo de documento se configura según sus necesidades
Respuesta: "error": "The client is required for this type of document if the amount is greater than or equal 10.0"
This document type has the following client attributes required: "Rut del Cliente"
Descripción: Verifica la configuración del tipo de documento. En caso que no necesitar estos datos, colocate en contacto con ayuda@bsale.app
Respuesta: "error": "This document type has the following client attributes required: "Rut del Cliente""
Couldn't find ListaPrecio with 'id_lista_precio'=
Descripción: Verifica que la sucursal tenga definida una lista de precios por defecto
Respuesta: "error": "Couldn't find ListaPrecio with 'id_lista_precio'= "
Max sku exceeded
Descripción: Verifica la cantidad de skus en tu plan contratado, contacta a tu ejecutivo
Respuesta: "error": "max sku exceeded"
Sku maximum reached, contact emontero@imaginex.cl
Descripción: Verifica la cantidad de skus en tu plan contratado
Respuesta: "error": "sku maximum reached, contact emontero@imaginex.cl"
The document amount is higher than the client deposit amount
Descripción: Verifica que el cliente no tiene un monto de abono igual al usado en el tipo de pago
Respuesta: "error": "The document amount is higher than the client deposit amount"
This document only allow clients with companyOrPerson = 1
Descripción: Verifica la configuración del tipo de documento. Valida la restricción de uso de cliente
Respuesta: "error": "This document only allow clients with companyOrPerson = 1"
Invalid percentage, negative values are not allowed for this type of document
Descripción: Verifica la configuración del tipo de documento
Respuesta: "error": "Invalid percentage, negative values are not allowed for this type of document"
The sii caf used is expired, you must request and upload a new one
Descripción: Verifica los folios electrónicos, en caso de ser necesario cargar nuevos
Respuesta: "error": "The sii caf used is expired, you must request and upload a new one"
Undefined method `has_key?' for Array:0x005644a47c1610
Descripción: Verifica que que no estés enviando arreglos en nodos
Respuesta: "error": "undefined method `has_key?' for Array:0x005644a47c1610"
Document amount is less than the minimum allowed
Descripción: Verifica el monto mínimo del documento (Configuración tipo documento)
Respuesta: "error": "document amount is less than the minimum allowed"
Invalid country code in customsData
Descripción: Verifica las propiedades de la factura de exportación
Respuesta: "error": "invalid country code in customsData"
Invalid sale mode in customsData
Descripción: Verifica las propiedades de la factura de exportación
Respuesta: "error": "invalid sale mode in customsData"
There is no stock for this products: "code"
Descripción: Verifica el code devuelto por la respuesta, debe tener stock para ser vendido
Respuesta: "error": "There is no stock for this products: "code""
Use 'comment' to especify the serie of detailid to dispatch
Descripción: Verifica que estás ingresando una serie en el detalle del documento, como indica la respuesta (comment)
Respuesta: "error": "Use 'comment' to especify the serie of detailid to dispatch."
closed box
Descripción: El documento que estás intentando eliminar, pertenece a una caja cerrada. Debes abrir caja del día de generación del documento y reintentar.
Respuesta: "error": "closed box"

500

The requested resource is not available
Descripción: Verifica que estás ingresando una url válida. Considera además el rate limit de nuestra API
Respuesta: "error": "The requested resource is not available"

Ayuda

info

Si tienes un error no documentado puedes comunicarte con nosotros ingresando a la comunidad de slack 👋