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ódigo | Descripción | |
|---|---|---|
| 400 | Bad Request | Petición inválida |
| 401 | Unauthorized | Access Token incorrecto |
| 402 | Payment Required | Instancia bloqueada por no pago |
| 403 | Forbidden | No tiene autorización para acceder al recurso solicitado |
| 404 | Not Found | Recurso solicitado no pudo ser encontrado |
| 405 | Method Not Allowed | El método o acción solicitada no está permitida en el recurso |
| 429 | Too Many Requests | La solicitud no fue aceptada porque la solicitud ha excedido el límite (3.000 request x 300 segundos) |
| 500 | Internal Server Error | Ocurrió un error no esperado en el servidor que procesa la petición |
| 502 | Unknown Error | Un 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 👋