Ejemplos por país

⚠️ Errores comunes

Esta guía lista los errores frecuentes en Argentina tal como aparecen en la API Koywe / FACTO cuando la emisión no se completa y el objeto result llega con status: 2.

---

Formato común de result (status 2)

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - <texto exacto del error> - "
}

El texto que sigue al prefijo fijo Document generated but could not be sent to the Tax bureau - puede venir de dos lugares:

• Validaciones de FACTO (secciones 2 a 9): se revisan antes de llamar a ARCA. El documento no se informa a ARCA.
• Respuesta de ARCA (sección 1): FACTO envió el comprobante al web service WSFE y ARCA lo rechazó o no respondió.

En ambos casos el comprobante no queda autorizado (no tiene CAE) y ARCA no lo registra. Corrija el dato indicado y emita nuevamente. Vea el detalle de estados en Ciclo de facturación.

---

1) Errores de ARCA

Formato de los rechazos

Los errores de ARCA llegan en uno de dos formatos:

• Rechazo de la solicitud (por ejemplo, número no correlativo o punto de venta no habilitado):

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error code: <código> - description : <descripción> -"
}

• Rechazo del comprobante (Resultado R): cada observación llega con su código y descripción. Puede haber varias en el mismo mensaje:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: Code : <código> Description : <descripción> - "
}

En ambos casos la respuesta trae el documento en borrador (document_status 0) con su document_id. Si envió document_number, el borrador conserva ese número.

1.1) Error 10016 — número no correlativo

ARCA solo acepta el número siguiente al último autorizado para el mismo punto de venta y tipo de comprobante, con una fecha coherente con la del último comprobante.

FACTO toma el número así:

• Si envía document_number, se usa ese número.
• Si no lo envía, se usa el último número emitido en FACTO para ese punto de venta (document_sequence_code) y tipo de documento, más 1.

Por eso el 10016 aparece cuando ya emitió comprobantes en ese punto de venta fuera de FACTO (por ejemplo, en el sitio de ARCA o con otro sistema) o cuando envía un document_number que no es el siguiente.

Revisa: consulte en ARCA el último número autorizado para ese punto de venta y tipo de comprobante, y envíe document_number con el número siguiente. Si emitió comprobantes fuera de FACTO, no omita document_number: la numeración de FACTO puede estar atrasada respecto de ARCA y se repetiría el error.

Revise también la fecha: issue_date no puede ser anterior a la del último comprobante autorizado y debe estar dentro del rango de fechas que acepta ARCA según el concepto y el tipo de comprobante. Por ejemplo, en una factura local de productos (invoice_concept 1) la fecha puede ser hasta 5 días anterior o posterior a la de envío, sin pasar al mes siguiente. Si el mensaje persiste, revise los rangos que publica ARCA para su tipo de comprobante.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error code: 10016 - description : El numero o fecha del comprobante no se corresponde con el proximo a autorizar. Consultar metodo FECompUltimoAutorizado. -"
}

1.2) Punto de venta no habilitado

El punto de venta se envía en document_sequence_code (por ejemplo "1"). Debe estar dado de alta en ARCA como punto de venta de factura electrónica por web service (RECE) para el CUIT del emisor. Un punto de venta creado solo para el facturador en línea de ARCA ("Comprobantes en línea") no sirve para emitir por la API. Para comprobantes de exportación (clase E, document_type_id 123 a 125) el punto de venta debe ser de tipo Comprobantes de Exportación - Web Services.

Revisa: en ARCA, Administración de puntos de venta y domicilios, que el punto de venta exista, esté activo y su sistema sea web service. Luego envíe ese número en document_sequence_code.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error code: 10004 - description : El punto de venta informado no se encuentra habilitado para usar en el presente WS. Consultar metodo FEParamGetPtosVenta. -"
}

Nota: ARCA usa distintos códigos según la causa (por ejemplo, punto de venta fuera de rango o no dado de alta para web service). Guíese por el código y la descripción que lleguen en error_message. En el ambiente de homologación (sandbox) ARCA puede aceptar un punto de venta que no está dado de alta, por lo que este error puede no aparecer en sus pruebas.

1.3) Error 501 — servicio de ARCA no disponible

ARCA no pudo procesar la solicitud. No es un error de los datos enviados.

Revisa: reintente la emisión más tarde con los mismos datos.

Si la emisión terminó sin respuesta (por ejemplo, por tiempo de espera agotado), antes de reintentar consulte en ARCA si el comprobante quedó autorizado, para no emitirlo dos veces.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - El servicio de ARCA no está disponible, no fue posible completar la emisión. Intente más tarde. Detalle del Error entregado: 501 - <detalle de ARCA> - "
}

1.4) Solicitud rechazada por el web service

ARCA rechazó la solicitud completa antes de evaluar el comprobante (por ejemplo, por un dato con formato inválido).

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: ARCA rejected the request: <código> - <detalle de ARCA> - "
}

---

2) Datos del emisor

Los datos del vendedor van con prefijo issuer_ en la cabecera. Si falta un dato obligatorio, el mensaje sigue el patrón The field '…' is required and cannot be empty. El ejemplo usa issuer_tax_id_code, pero el mismo patrón aplica a issuer_tax_id_type, issuer_legal_name, issuer_address, issuer_district, issuer_department, issuer_city, issuer_country_id, issuer_phone, issuer_activity e issuer_postalcode.

Revisa: que ningún valor obligatorio vaya vacío o null. Si no envía un dato, FACTO lo toma de la configuración de la empresa; en ese caso, complete la configuración.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error : The field 'issuer_tax_id_code' is required and cannot be empty. - "
}

El CUIT del emisor debe tener 11 dígitos:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error : The field 'issuer_tax_id_code' must be a valid 11-digit CUIT. - "
}

---

3) Concepto y fechas del servicio

Toda factura argentina debe indicar invoice_concept en header.additional.ar_header: 1 Productos, 2 Servicios o 3 Productos y Servicios.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: For Argentine invoices you must provide the field invoice_concept (1 Products, 2 Services, 3 Products and Services) - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: For Argentine invoices you must provide a valid invoice_concept (1 Products, 2 Services, 3 Products and Services). - "
}

Con concepto 2 o 3 también son obligatorios service_date_from, service_date_to y service_payment_due_date. El mensaje indica el campo que falta:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: If invoice_concept is 2 (Services) or 3 (Products and Services), you must provide the field service_date_from - "
}

---

4) Receptor

4.1) Condición frente al IVA (receiver_vat_condition_id)

receiver_vat_condition_id (en header.additional.ar_header) es obligatorio y su valor debe corresponder a la clase del comprobante. Vea los códigos en Tabla de códigos.

Clase	Valores permitidos
A y A sujeta a retención	1, 6, 13, 16
B	4, 5, 7, 8, 9, 10, 15
C	1, 4, 5, 6, 7, 8, 9, 10, 13, 15, 16
E (exportación)	8, 9

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field receiver_vat_condition_id is required and must be included in the request. - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: For invoices of type A, the field receiver_vat_condition_id is invalid. Allowed values are: 1 (VAT Registered), 6 (Monotax), 13 (Social Monotax), and 16 (Promoted Independent Worker Monotax). - "
}

El mismo mensaje existe para las demás clases (type B, type C, type E, type R y type A subject to withholding), con su lista de valores.

4.2) Identificación del receptor (Factura B)

A un consumidor final sin identificar se le factura omitiendo receiver_tax_id_type y receiver_tax_id_code, o con receiver_tax_id_type AR-XXX. Si envía el tipo, también debe enviar el número:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field receiver_tax_id_code is required when receiver_tax_id_type is provided. To invoice an unidentified final consumer, omit both fields or use AR-XXX. - "
}

Desde ARS 10.000.000 (RG 5700/2025 de ARCA) el consumidor final debe estar identificado:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The final consumer must be identified (receiver_tax_id_type and receiver_tax_id_code) when the total is ARS 10,000,000 or more (ARCA RG 5700/2025). - "
}

Con pasaporte (AR-PP), el número debe tener solo dígitos:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: For receiver_tax_id_type AR-PP, receiver_tax_id_code must contain only digits (ARCA does not accept letters in the document number). - "
}

---

5) Punto de venta y numeración

En Argentina, document_sequence_code es el punto de venta de ARCA.

5.1) Varios puntos de venta sin document_sequence_code

La cuenta tiene más de un punto de venta para ese document_type_id y la petición no indica cuál usar.

Revisa: envíe siempre document_sequence_code cuando emita desde más de un punto de venta.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error : There is more than one sequence for this document type and no document_sequence_code was provided. - "
}

5.2) Punto de venta nuevo (alerta informativa)

El document_sequence_code enviado no existía en FACTO para ese tipo de documento y se creó. Puede aparecer junto a otros textos en error_message. El número "5" es solo un ejemplo.

Si el punto de venta ya tenía comprobantes autorizados en ARCA, envíe document_number en la primera emisión para evitar el error 10016.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - The sequence code 5 did not exist for this document type. It was created with document_number 1 - "
}

---

6) Montos, moneda e impuestos

net_amount, total_amount y currency_id son obligatorios. currency_id debe ser un código de moneda válido de ARCA.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field total_amount is required and must be provided in the request. - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The provided currency_id  does not match any valid ARCA currency code.. - "
}

Cada impuesto del bloque taxes debe traer tax_type_id, tax_percentage, tax_amount y tax_base_amount. El mensaje indica el campo que falta:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field tax_amount is required in the taxes section and must be included in the request. - "
}

---

7) Notas de crédito y débito (referencias)

Las notas de crédito y débito deben referenciar el comprobante asociado en references, con reference_branch_office_code (punto de venta), document_type_id y reference_document_id o reference_number. El documento referenciado debe haber sido emitido en FACTO por la misma empresa.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: Either reference_number or reference_document_id is required for each reference. - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The referenced document (reference_number 15) was not found among the documents issued by the company. References to third-party documents are not allowed. - "
}

---

8) Exportación (clase E)

Las facturas y notas de exportación (document_type_id 123, 124 y 125) exigen receiver_country_id, receiver_tax_id_code, receiver_address y language_code (1 Español, 2 Inglés, 3 Portugués), y existing_permission (S o N) en header.additional.ar_header. El mensaje indica el campo que falta:

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: If the invoice type is 'E' (export), the field 'receiver_country_id' must be provided. - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: Invalid value for field 'existing_permission'. Only 'S' or 'N' are accepted - "
}

---

9) CBU informada y opcionales

informed_cbu solo se acepta en comprobantes A (document_type_id 111 a 114). Debe tener 22 dígitos con dígitos verificadores válidos. informed_alias requiere informed_cbu y debe tener entre 6 y 20 caracteres.

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field informed_cbu is invalid: its check digits do not match. - "
}

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field informed_alias requires the field informed_cbu. - "
}

optionals debe ser una lista de objetos con id numérico y value no vacío, sin id repetidos. ARCA valida qué opcionales acepta cada comprobante y los rechaza con su propio código (sección 1).

"result": {
  "status": 2,
  "error_message": "Document generated but could not be sent to the Tax bureau - Error: The field optionals cannot contain repeated ids. - "
}

---

Referencias útiles

• Ciclo de facturación
• Crear documentos
• Buenas prácticas
• Tabla de códigos