Códigos de error

A continuación se muestra la lista de posibles códigos de error con información adicional sobre cómo resolverlos.

already_exists

Este error ocurre cuando se intenta crear un registro ya existente en Siigo Nube. Usa un valor diferente y único para el id o código e intenta nuevamente.

delete_not_allowed

El recurso no se puede eliminar porque tiene movimientos o transacciones relacionadas.

documents_service

El servicio de documentos no esta disponible, intente en unos minutos.

Este error ocurre cuando se envía algún parámetro que no está configurado en el comprobante. Verifica la configuración de los siguientes parámetros de Factura de Venta en el menú Configuración > Ventas > Documentos > Facturas de ventas y Elige el tipo de factura: Centro de costos, Numeración automática, Descuentos por valor o porcentaje.

company_settings

Este error ocurre cuando se envía algún parámetro que no está configurado en los parametros de la empresa.

header_required

Este error ocurre cuando NO se envía un header requerido, es probable que no este enviando el Header: SiigoAPI-Application-Id, que es obligatorio y en el cuál se debe enviar el nombre del software/aplicación que se está integrando con Siigo Nube.

Consulta más detalles aquí.

invalid_array

Este error ocurre cuando se envía un array con valores inválidos.

Contacts: Este error ocurre al exceder la cantidad máxima de contactos, puedes crear hasta 10 contactos por cliente.

Name: Debes verificar los siguientes escenarios:

Si estás creando un cliente tipo 'Physical'

{
	"name": ["Marcos", "Castillo"]
}

Si estás creando un cliente tipo 'Moral'

{
	"name": ["Stark Industries"]
}

Payments: Este error ocurre al envíar condiciones de pago inválidas, debes consultar las condiciones de pago válidas y verificar si son de tipo cartera: Si ingresa dinero o proveedor: En caso de compras.

Prices: Este error ocurre al exceder la cantidad máxima de Listas de precio, puedes crear hasta 12 Listas de precio por producto.

Retentions: De acuerdo a la configuración del comprobante en el menú Configuración > Ventas > Documentos > Facturas de ventas, Elige el tipo de factura y en la sección de configuraciones complementarian se encuentra: Retenciones

Ret.IVA: Se aplica sobre el valor de la factura.
Ret.ISR: Se aplica sobre el valor de la factura.

Taxes: Este error ocurre:

Si envías más de la cantidad de impuestos permitidos, puedes enviar hasta 3 impuestos.

Items: Este error ocurre:

En factura de venta ocurre si envías más de 500 items.

invalid_amount

El valor especificado no es válido. El monto debe ser un número positivo en la unidad monetaria correspondiente y no exceder el monto mínimo o máximo (99,999,999,999.99).

Consideraciones:

El total de payments debe coincidir con el total de la factura, el valor máximo es máximo (9,999,999,999,999.99).
El campo de price permite hasta 6 decimales.
Los demás campos como discount permiten hasta 2 decimales.
No puede enviar un valor mayor al valor del saldo de la "cuota".

invalid_code

El código no puede tener comillas simples (') ni espacios. Expresión regular: ^[^'\s]+$

invalid_cfdi

La forma de pago CFDI es incorrecta según el método seleccionado, por favor valide si el código de la forma corresponde al método PUE O PPD.

invalid_date

Estás enviando una fecha inválida, verifica el limite de días para facturas electronicas que es 3 días inferior o 1 día superior a la fecha actual. También verifica los formatos válidos para las fechas:

Date: yyyy-MM-dd
Date and time in UTC: yyyy-MM-ddTHH:mm:ssZ

invalid_description

Estás enviando una descripción inválida. Expresión regular: ^$|^[\w\.@-\\%_;()\]#?¡[/:{ } *+,$"\sñáéíóúÁÉÍÓÚüÜ\-"]+$

invalid_document

El id del tipo de comprobante no corresponde al que estás creando.

invalid_email

La dirección de correo electrónico no es válida, verifica que la dirección de correo electrónico tenga el formato correcto. Expresión regular: ^([-+\.]*\w)+[-+\.]*@([\w-]+\.)+[\w-]{2,}$

invalid_rfc_id

Estás enviando una identificación inválida, se deben enviar las identificaciones de acuerdo con las siguientes expresiones regulares:

Moral: ^([A-ZÑa-zñ&]{3}[0-9]{6}[A-ZÑa-zñ0-9]{3})$
Physical: ^([A-ZÑa-zñ&]{4}[0-9]{6}[A-ZÑa-zñ0-9]{3})$

invalid_country_code

Si se coloca un código de méxico en el código de pais de un person_type = Foreign debe retornar este código.

invalid_fiscal_regime

Si se envía un régimen fiscal que no es válido para el tipo de persona mencionada al crear o editar un tercero. Consulte el listado de códigos válidos por el SAT para cada tipo de persona aquí.

invalid_name

Estás enviando un nombre inválido. Expresión regular: ^[\w\.@-\\%_;()\]#?¡[/:{ } *+,$"\sñáéíóúÁÉÍÓÚüÜ\-"]+$

invalid_range

El campo solo permite un valor entre los rangos indicados.

invalid_reference

Este error ocurre cuando envías un id o código que no existe en Siigo Nube para este campo. Verifica los Catálogos.

invalid_total_payments

El sistema valida que el valor total pagado (suma de payments[i].value) coincida con el total de la factura (suma de los totales de los ítems).

El total por ítem se calcula así:

ValorBase = Redondear(Cantidad * ValorUnitario - Descuento, 2)
IVA = Redondear((baseValue * PorcentajeIVA)/100, 2)
TotalItem = Redondear(ValorBase + IVA, 2)

Ejemplo:

Cantidad = 10
ValorUnitario = 100.00
Descuento = 50.00
ValorBase = Redondear(10 * 100.00 - 50.00, 2) = 950.00
IVA = Redondear((950.00 * 19)/100, 2) = 180.50
TotalItem = Redondear(950.00 + 180.50, 2) = 1130.50

invalid_retentions

De acuerdo a la configuración del comprobante en el menú Configuración > Ventas > Documentos > Facturas de ventas, Elige el tipo de factura y en la sección de configuraciones complementarian se encuentra: Retenciones

Ret.IVA: Se aplica sobre el valor de la factura.
Ret.ISR: Se aplica sobre el valor de la factura.

invalid_type

El tipo de dato enviado no es correcto, valida el tipo del campo. (string, bollean, number)

invalid_use

El código del listado es diferente al que corresponde según el person_type.

invalid_value

El valor especificado no es válido. (Cantidades, Consecutivos y Cuotas).

length_max

Verifica que no superas la longitud máxima del campo indicada en el mensaje del error.

El máximo de carácteres es:

En productos: code = 30 carácteres. name = 100 carácteres. reference = 80 carácteres. description = 500 carácteres. barcore = 50 carácteres. brand = 50 carácteres.

length_min

Verifica la longitud mínima del campo indicada en el mensaje del error.

not_found

Recurso no encontrado.

duplicated_document

El documento ya existe, por favor valide la información.

parameter_empty

Se utiliza para los campos que son parámetros obligatorios y no se envío en la petición.

parameter_inactive

El parámetro que estás utilizando está inactivo. Usa un parámetro diferente o activa el parámetro actual nuevamente.

Grupos de inventario: Puedes validar en en Siigo Nube en el menú lateral: Configuración > Productos y servicios > Generales > Clasificación de producto y servicio

Usuarios: Puedes validar en en Siigo Nube en el menú lateral: Reportes > Reportes de configuración > Usuarios > Administración de usuarios

Condiciones de Pago: Puedes validar en en Siigo Nube en el menú lateral: Configuración > Contabilidad > Generales > Condiciones de Pago

Impuestos: Puedes validar en Siigo Nube en el menú lateral: Configuración > Contabilidad > Generales > Impuestos

Listas de Precios: Puedes validar en en Siigo Nube en el menú Configuración > Productos y servicios > Generales > Listas de precios de venta ahi puedes habilitar hasta 12 de listas de precios.

parameter_required

No se proporcionaron uno o más valores obligatorios. Asegúrate de que las solicitudes incluyan todos los parámetros obligatorios.

Condiciones de Pago: Debes enviar el query parameter document_type=FV (FV)

Productos: Debes enviar obligatoriamente el campo code, name, account_group, unit y key.

parameters_exclusive

Se proporcionó un valor no permitido, debe enviarse solo los valores existentes para los campos de siigo nube, consulta la documentación de nuestra API o el mensaje de error devuelto para verificar los valores que están permitidos al crear o modificar el recurso especificado.

En productos: type = El sistema solamente recibe los valores Product, Service y ConsumerGood para este campo.

product_settings

Este error sucede si envías una bodega en la creación de factura y el producto no maneja control de inventarios.

requests_limit

Están llegando solicitudes demasiado rápido a la API. Recomendamos una retirada exponencial de sus solicitudes.

Importante:

Para la empresa de pruebas las solicitudes son de 10 request por minuto
Empresas en producción son 100 request por minuto.

unauthorized

No estás autorizado, verifica el token de acceso.

update_not_allowed

No se puede actualizar el grupo de inventarios del producto, debido a que ya tiene movimientos.

unhandled_error

Error no controlado, escríbenos a [email protected] para ayudarte y dar claridad a este error, por favor aclaranos cual es el proceso que realizaste y una copia del JSON de la petición.

request_timeout

Siigo API no logró completar la solicitud dentro del tiempo que estaba preparado para esperar. Puede intentar de nuevo en unos segundos.

service_unavailable

Siigo API actualmente no está disponible debido a una sobrecarga temporal o mantenimiento programado. Puede intentar de nuevo en unos segundos.

warehouse_settings

Este error sucede si envías una bodega en la creación de factura o nota crédito y NO está activo el manejo de bodegas. Puedes validar en el menú Configuración > Productos y servicios > Generales > Configuración de Bodegas ahi puedes habilitar el manejo de bodegas y crear más bodegas.

Códigos de error

On this page