Tipos de errores

• Estándar de códigos de error: Todo código de error será una cadena de tres dígitos XXX que especifica el tipo de error general, seguida de un guion y un modificador de subtipo alfanumérico Y.

  A continuación encontrará los tipos, subtipos y códigos definidos hasta la fecha. Estos se retornarán en los campos type, subType y id respectivamente. Cada tipo y subtipo irá con su respectivo código. Los errores generales por lo general no tendrán un modificador alfanumérico.

Errores de solicitud

Rango de códigos: 0XX-YYZ

Errores de Solicitud:

Puede ocurrir porque la solicitud no incluye valores obligatorios o no define uno de los valores permitidos para un determinado campo.

Código	Nombre	Descripción
000-99	unknownError	Error desconocido o no contemplado en la solicitud.

Errores de Validación (001-XYZ):

Los errores de validación se producen cuando hay campos con información incoherente o mal diligenciada.

Errores de Validacion Generales:

Código	Nombre	Descripción
001-D1	wrongDate	La fecha A debe ser menor, mayor o igual que la fecha B.
001-D2	wrongDate	La fecha de emisión del documento no pertenece al rango de facturación configurado.
001-DC1	consecutiveError	El prefijo de identificación consecutiva no se corresponde con el rango de facturación de la unidad de negocio.
001-DC2	consecutiveError	El número de identificación consecutivo no pertenece al rango de facturación de la unidad de negocio.
001-DE1	consecutiveAlreadyUsed	Un documento con el consecutivo que está asignando ya existe en el documento que está creando.
001-DL1	sameDocumentLines	No puede haber dos líneas de documento con el mismo line_id.
001-DS1	withholdingSubtotalsError	Hay inconsistencias presentadas en los subtotales de retenciones.
001-DS2	taxesSubtotalsError	Hay inconsistencias presentadas en los subtotales de impuestos.
001-DS3	percentSubtotalsError	El porcentaje reportado subtotales de {tax_name} en las líneas no son consistentes con los del documento.
001-DS4	subtotalsError	La suma de sum(documentLines/taxDescription/taxAmount) = A cuando es {tax_name}, no es consistente con taxDescription/taxAmount = B.
001-DS5	subtotalsError	La suma de sum(documentLines/taxDescription/taxableAmount) = A cuando es {tax_name}, no es consistente con taxDescription/taxableAmount = B.
001-DT1	discountsError	Cuando comparamos documentTotals/allowanceTotalAmount(A) con la suma de descuentos(B) en las líneas, esta no coincide.
001-DT2	chargesError	Cuando comparamos documentTotals/chargeTotalAmount(A) con la suma de cargos(B) en las líneas, esta no coincide.
001-DT3	lineError	Cuando comparamos documentTotals/lineExtensionAmount(A) con la suma de los importes de las extensiones de línea(B) en las líneas no coincide.
001-DT4	taxExclusiveError	Cuando comparamos documentTotals/taxExclusiveAmount(A) con la suma del importe del impuesto(B) en las líneas no coincide.
001-DT5	taxInclusiveError	Cuando comparamos documentTotals/taxInclusiveAmount(A) con la suma del importe de los impuestos(B) en las líneas no coincide.
001-DT6	prePaidAmountError	Cuando comparamos documentTotals/prePaidAmount(A) con la suma de prepagos(B) no coincide.
001-DT7	payableAmountError	Cuando comparamos documentTotals/payableAmount = A con el valor calculado B de los totales del documento los valores no coinciden..
001-DW1	withholdingsInconsistencies	Inconsistencias presentadas en las retenciones.
001-DW2	withholdingsInconsistencies	Las retenciones reportadas en las líneas son diferentes de las retenciones reportadas a nivel de documento.
001-DW3	withholdingDescriptionError	Error presentado en las retenciones.
001-DW4	withholdingGroupsError	No puede haber dos grupos de retención del mismo tipo en una línea.
001-DW5	withholdingSubtotalError	Cuando se opera sum(withholdingSubtotal/taxAmout) = A, no es consistente con el valor introducido B.
001-DW6	notConsistentWithholdingsError	Cuando la operación (sum((withholdingSubtotal/taxableAmout * withholdingSubtotal/percent) - withholdingSubtotal/taxAmout) = A, no es consistente con el valor introducido B.
001-DW7	withholdingsSubtotalsError	Debe haber subtotales de las retenciones pagadas.
001-DW8	withholdingsPercentError	“Cuando la operación (#{importe imponible} * (#{withholding.percent} / 100)) = A, no es coherente con el valor introducido B.
001-DW9	taxableAmountError	El valor de taxable_amount(A) debe ser mayor o igual a 0.
001-DW10	taxableAmountError	El valor de taxable_amount(A) debe ser menor o igual que (B).
001-DW11	subtotalsPercentagesError	No puede haber dos porcentajes en los subtotales con el mismo valor.
001-E1	alreadyHadEventError	Este documento ya tiene el evento X.
001-E2	notApprovedByDIANError	Para crear el evento X en el documento, debe haber sido aprobado por la DIAN.
001-E3	cannotCreateEventError	El documento está en estado X, por lo que no se puede crear el evento.
001-E4	cannotCreateEventToTheInvoice	No es posible crear el evento X para facturar con el ID dado.
001-E5	invoiceDoesntExist	La factura a la que se le intenta generar el evento no existe en el sistema.
001-E6	invoiceTVEvent	Esta factura no puede ser una factura de ‘Título Valor’. Esta factura tiene un importe a pagar de 0, y si quiere convertirla en un ‘Título Valor’ la factura debe tener un valor mayor que cero en el crédito.
001-E7	invoiceEventError	La factura a la que se intenta generar el evento X, tiene notas de crédito y débito anteriores.
001-E8	invoiceEventError	La factura a la que se intenta generar el evento X, tiene notas de crédito anteriores.
001-E9	invoiceEventError	La factura a la que se intenta generar el evento X, tiene notas de cargo anteriores.
001-F1	fieldNotExist	El campo no puede existir, ya que el campo X existe.
001-F2	fieldCantBeBlankError	El campo no puede estar en blanco.
001-FN1	non-floating Number	El valor X no es flotante y no es decimal.
001-GS1	gettingStructureError	Errores en la estructura get_field.
001-ID1	issueDateError	La fecha {date_time} debe ser menor que la fecha de emisión de la factura.
001-LA1	lineExtensionAmountError	Error presentado en lineExtensionAmount.
001-LA2	lineExtensionAmountError	Cuando la operación (price - discounts + charges = A, no es consistente con el valor introducido B.
001-LA3	lineExtensionAmountError	Al operar (precio - descuentos) + cargos = A = valor, debe ser mayor o igual a 0.
001-LA4	lineExtensionAmountError	El valor del importe de la ampliación de la línea no es coherente con el de la Nota de crédito/nota de ajuste y la factura/factura de compra anteriores.
001-LI1	ineIDError	El LineId: X no coincide con ninguna de las facturas.
001-LT1	lineTotalsError	La suma de sum(documentLines/taxDescription/taxAmount) = A , no es consistente con taxDescription/taxAmount = B.
001-LT2	sumLinesError	Totales: Error presentado al comparar los resultados totales y la suma de las líneas.
001-N1	nameError	Debe introducir la razón social o el nombre completo de la persona.
001-N2	firstNameError	El nombre de la persona debe introducirse en el campo: (first_name).
001-N3	surNameError	El primer apellido de la persona debe introducirse en el campo: (first_surname).
001-O1	organizationError	Actualmente, la organización no está configurada para emitir facturas.
001-O1	organizationError	La organización no existe en el sistema, por lo que no está habilitada para emitir facturas.
001-OU1	organizationUnitError	Actualmente, la unidad organizacional no está configurada para emitir facturas.
001-OU1	organizationUnitError	La unidad organizacional no existe en el sistema, por lo que no está habilitada para emitir facturas.
001-N4	invalidCorporateName	Según el tipo de identificación, debe introducirse el nombre de la empresa.
001-PC1	priceChangeError	When operating (base_amount * (percentage / 100)) = A, it is not consistent with the entered value B.
001-PD1	paymentDescriptionError	Descripción del pago(Prepayments): Error presentado en la lista de pre-pagos.
001-PI1	productsQuantityError	No es posible generar más notas de crédito en esta factura. La cantidad supera el número de artículos del documento, menos los incluidos en las notas anteriores.
001-PM1	primeModifierError	Error presentado en el objeto priceModifier de tipo {type}.
001-PV1	differentPriceValueError	En el caso de una nota de crédito parcial/nota de ajuste, el valor del precio debe ser el mismo que el de la factura/la factura de compra.
001-T1	taxesInconsistencies	Se presentan incongruencias en los impuestos.
001-T2	taxesDontExistInLines	El documento informaba de impuestos que no existen en las líneas.
001-T3	taxesDontExist	Los impuestos que no existen en el tipo del documento fueron reportados en las líneas.
001-T4	sumOfTaxesError	Al comparar la suma de los impuestos de las líneas es diferente de la suma de los reportados en el documento.
001-T5	sumOfTaxesNotConsistent	Cuando se opera sum(documentLines/taxDescription/taxAmount) = A , no es consistente con sum(taxDescription/taxAmount) = B.
001-T6	sumOfTaxesNotConsistent	Cuando se opera sum(documentLines/taxDescription/roundingAmount) = A, no es consistente con sum(taxDescription/roundingAmount) = B.
001-T7	taxesReportedAreDifferent	Los impuestos declarados en las líneas son diferentes de los impuestos declarados a nivel de documento..
001-T8	taxNotFoundInTotals	El {tax.name.description} reportado en las líneas no se encuentra en los totales.
001-TD1	taxDescriptionError	Error presentado en la taxDescription: {nombre_del_impuesto}.
001-TD2	taxGroupsError	No puede haber dos grupos fiscales del mismo tipo en una línea.
001-TD3	taxInconsistencies	Cuando se opera sum(taxSubtotal/taxAmout) = A, no es consistente con el valor introducido B.
001-TD4	taxInconsistencies	Al operar (sum((taxSubtotal/taxableAmout * taxSubtotal/percent) - taxSubtotal/taxAmout)withholding_name, no es consistente con el valor introducido X.
001-TS1	taxSubtotalsError	Error presentado en los subtotales del impuesto: Deben existir subtotales del impuesto pagado.
001-TS2	taxSubtotalsValueError	El valor de taxable_amount(X) debe ser mayor o igual a 0.
001-TS3	taxSubtotalsValueError	El valor de taxable_amount(A) debe ser menor o igual que (B).
001-TS4	taxSubtotalsPercentageError	No puede haber dos porcentajes en los subtotales con el mismo valor.
001-TS5	salesTaxError	Error presentado en los subtotales de impuestos: IVA(Impuesto sobre las ventas).
001-TW1	taxesOrWitholdingsError	Los impuestos/retenciones declarados en las líneas son diferentes de los impuestos/retenciones declarados en el nivel del documento.
001-V1	wrongValue	En el valor X, el valor debe ser mayor o igual a N.
001-V2	wrongValue	En el valor X, el valor debe ser menor o igual a N.
001-V3	wrongValue	En el valor X, el número de decimales en su parte flotante debe tener al menos N dígitos.
001-V4	wrongValue	En el valor X, el número de decimales en su parte flotante debe tener N o menos dígitos.
001-V5	wrongValue	En el valor X, el número de decimales en su parte flotante debe estar entre N y M dígitos.
001-V6	wrongValue	El valor X introducido no corresponde a un GTIN.
001-V7	notANit	El valor X introducido no corresponde a un NIT.
001-V8	percentageError	El porcentaje debe estar entre 1 y 100 con sólo dos dígitos en su parte decimal si tiene una.
001-V9	textSizeError	El valor en Y debe tener minimo/maximo N caracteres.

Errores de Validacion para facturas:

Código	Nombre	Descripción
001-EI1	invoiceRequestError	Este error solo se presenta en el contexto de facturas y solo aplican a los procesos de factura.
001-EI2	noteCreationError	No se puede crear la nota a la factura de venta, ya que esta no ha sido aprobada por la DIAN.
001-AIU1	invalidAIU	La solicitud de creación de factura AIU no cumple los estándares para este tipo de factura
001-AIU2	invalidAIU	La solicitud de creación de factura AIU incluye más de dos líneas de detalle.
001-AL1	invalidAIUProductLines	La solicitud de creación de factura AIU incluye más de dos líneas de detalle.
001-AT1	invalidAIUTaxes	La solicitud de creación de factura AIU tiene errores de validación tributaria.
001-ALM1	invalidAIUModifiers	La solicitud de creación de factura AIU tiene modificadores de líneas de detalle (Cargos o Descuentos).
001-ALM2	invalidAIUModifiers	La solicitud de creación de factura AIU tiene modificadores de factura (Cargos o Descuentos).
001-PEI1	noteCreationError	No se puede crear la nota a la factura de compra, ya que esta no ha sido aprobada por la DIAN.

Errores de Validacion para notas credito:

Código	Nombre	Descripción
001-EC1	creditNoteRequestError	Este error solo se presenta en el contexto de notas crédito y solo aplican a los procesos de notas crédito.

Errores de Validacion para notas debito:

Código	Nombre	Descripción
001-ED1	creditNoteRequestError	Este error únicamente se presenta en el contexto de notas débito y exclusivamente aplican a los procesos de notas débito.

Errores de Validacion para docuemnto soporte:

Código	Nombre	Descripción
001-AS1	supportDocumentRequestError	Este error sólo se produce en el contexto de los documentos de apoyo a la adquisición y sólo se aplica a los procesos de documentos de apoyo a la adquisición.

Errores DIAN (002-X):

Este tipo de error sólo se produce en las solicitudes realizadas a la DIAN.

Código	Nombre	Descripción
002	dianRequestError	Este error únicamente se presenta en las solicitudes hechas a la DIAN.

Errores de Paginación (003-X):

Los errores de paginación se producen porque la solicitud incluye valores que están fuera del rango de resultados permitidos o posibles.

Código	Nombre	Descripción
003-1	pageNumberError	Error de número de página. Por lo general se debe a que la solicitud invluye un número de página que se sale del rango de resultados permitidos o posibles.
003-2	pageSizeError	Error de tamaño de página. Por lo general se debe a que la solicitud invluye un número de página que se sale del rango de resultados permitidos o posibles.

Errores de YABI•CO (004-XYZ):

Son los errores internos de YABI•CO, suelen ser de generación de documentos o errores en base de datos.

Código	Nombre	Descripción	Mensaje de error
004-1	pdfGenerationError	Error de generación del PDF.	Error de representación gráfica del documento.
004-2	xmlGenerationError	Error de generación del XML.	Error de generación de documentos.
004-DB1	cannotCreateRecord	No se puede crear el registro en la base de datos.	Error de persistencia en la creación.
004-DB2	InvalidChangesetToCreateRecord	No es un changeset valido para crear un registro en la base de datos.	Error de persistencia en el changeset.
004-DB3	cannotModifyRecord	No se puede modificar el registro en base de datos.	Error de persistencia en la modificación.
004-DB4	modifyingRecordError	No es un changeset valido para modificar el registro en base de datos.	Error de persistencia en el changeset para modificación.
004-DB5	databasePartitionError	No se pudo crear la partición de la tabla en base de datos.	Error de partición de persistencia.
004-DC1	canotCreateDocumentError	En la versión actual de esta API no es posible importar este tipo de documentos.	Error de adición de documentos.
004-HR1	insertionRecordError	No puede insertar el registro historico.	Error de inserción de persistencia.
004-HR2	historicalRecordChangesetError	El changeset para el registro historico no es valido.	Error de persistencia en el changeset para insercion.
004-HR3	historicalRecordDataError	No tiene data para crear registros historicos.	Error de inserción de datos de persistencia.
004-RE1	requestError	Se ha producido un error al procesar la solicitud createOrganization.	Error de persistencia de Org.
004-RE2	requestError	Se ha producido un error al procesar la solicitud createOrganizationUnit.	Error de persistencia de Ou.

Errores de Autenticacion (090-X):

Los errores de autenticación pueden deberse a credenciales no válidas.

Código	Nombre	Descripción
090	authenticationError	Error de autenticación por credenciales no válidas.

Errores de llave o data no existente

Rango de códigos: 1XX-Y

Errores Generales:

Código	Nombre	Descripción
100	dataNotFound	Por lo general ocurre en contextos de creación o actualización. Se debe a que no existe información asociada a uno o más de los identificadores (UUID, NIT, C.C., etc.) presentes en la solicitud.
110	userNotFound	Ocurre en contextos de manejo de usuarios. Esto incluye; manejo de sesión, consulta de usuarios o modificaciones de usuarios.

Errores en unidades de negocio:

Código	Nombre	Descripción
100-BU1	businessUnitNotFound	Se debe a que no existe una Unidad de negocio asociada al uuid presente en la solicitud.

Errores generales en documentos:

Código	Nombre	Descripción
100-NE1	nonExistingDocumentError	No es posible anular el documento con el consecutivo X, porque el tipo de documento que se intenta anular no existe en el sistema.
100-NE2	notPossibleCreationDocumentError	No es posible anular el documento con el consecutivo X, porque el tipo de documento que se intenta anular no existe en el sistema.

Errores en facturas:

Código	Nombre	Descripción
100-EI1	invoiceNotFound	Se debe a que no existe una Factura asociada al UUID o consecutivo presente en la solicitud.
100-EI2	notPossibleVoidInvoice	No es posible anular la factura con el consecutivo X, ya que no existe en el sistema o ya tiene una nota credito.

Errores en notas credito:

Código	Nombre	Descripción
100-EC1	creditNoteNotFound	Se debe a que no existe una Nota Crédito asociada al uuid o consecutivo presente en la solicitud.
100-EC2	cantCreateCreditNote	No es posible crear una nota de crédito a la factura con el consecutivo X, porque la factura no existe en el sistema.

Errores en notas debito:

Código	Nombre	Descripción
100-ED1	debitNoteNotFound	Se debe a que no existe una Nota Debito asociada al uuid o consecutivo presente en la solicitud.
100-ED2	cantCreateDebitNote	No es posible crear una nota débito a la factura con el consecutivo X, porque la factura no existe en el sistema.

Errores en documentos soporte:

Código	Nombre	Descripción
100-AS1	supportDocumentNotFound	Se debe a que no existe un Documento soporte asociado al uuid o consecutivo presente en la solicitud.

Errores de data ya usada o existente

Rango de códigos: 2XX-Y

Errores Generales:

Código	Nombre	Descripción
200	dataAlreadyUsed	Uno o más campos en la solicitud tienen valores únicos ya utilizados.

Errores en facturas:

Código	Nombre	Descripción
200-EI1	invoiceConsecutiveAlreadyused	Consecutivo de Factura ya usado.

Errores en notas credito:

Código	Nombre	Descripción
200-EC1	creditNoteConsecutiveAlreadyUsed	Consecutivo de Nota Crédito ya usado.

Errores en notas debito:

Código	Nombre	Descripción
200-ED1	debitNoteConsecutiveAlreadyUsed	Consecutivo de Nota Débito ya usado.

Errores en documentos soporte:

Código	Nombre	Descripción
200-AS1	supportDocumentConsecutiveAlreadyUsed	Consecutivo de Documento Soporte ya usado.