Ejemplos por país

➕ Crear documentos

Colección de Postman

Para ayudarte con tu integración, descarga nuestra Colección de Postman aquí: https://github.com/koyweforest/api-billing-postman

Para facilitar las pruebas, puedes utilizar la siguiente información al emitir documentos:

account_id	CUIT	legal_name	activity	postalcode
29240	20357265992	Tecnologias Avanzadas S.A.	Servicios de desarrollo de software	1043

Factura A (Factura Electrónica A)

Para crear una nueva Factura A argentina a través del sistema de facturación electrónica ARCA, debes utilizar el endpoint /documents con los parámetros correspondientes y la información del contribuyente requerida por las regulaciones de AFIP.

Endpoint: https://api-billing.koywe.com/V1/documents
Método: POST
Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /

{
   "header":{
     "account_id": 29240,
     "document_type_id": "111",
     "received_issued_flag": 0,
     "issue_date": "2025-10-24",
     "issuer_tax_id_code": "20357265992",
     "issuer_tax_id_type": "AR-CUIT",
     "issuer_legal_name": "Tecnologias Avanzadas S.A.",
     "issuer_address": "Av. Corrientes 1234",
     "issuer_district": "San Nicolas",
     "issuer_city": "Ciudad Autonoma de Buenos Aires",
     "issuer_department": "Buenos Aires",
     "issuer_country_id": "88",
     "issuer_phone": "011-4321-5678",
     "issuer_activity": "Servicios de desarrollo de software",
     "issuer_postalcode": "1043",
     "receiver_tax_id_code": "30274688781",
     "receiver_tax_id_type": "AR-CUIT",
     "receiver_legal_name": "ESCUELA KEMPER URGATES",
     "receiver_address": "Calle Belgrano 456",
     "receiver_district": "Centro",
     "receiver_city": "Cordoba",
     "receiver_department": "Cordoba",
     "receiver_country_id": "88",
     "receiver_phone": "0351-487-2233",
     "receiver_activity": "Servicios educativos",
     "receiver_postalcode": "5000",
     "payment_conditions": "0",
     "currency_id": 1,
     "branch_office_code": 12,
      "additional":{
         "ar_header":{
            "invoice_concept": 1,
            "items_quantity": 1,
            "service_date_from": "2025-10-14",
            "service_date_to": "2025-10-14",
            "service_payment_due_date": "2025-10-10",
            "receiver_vat_condition_id": 1
         }
      }
   },
   "details": [
    {
      "quantity": 1,
      "line_description": "Prueba Koywe",
      "unit_measure": "UNI",
      "unit_price": 150,
      "long_description": "Test descripcion",
      "modifier_amount": 0,
      "total_taxes": 38.25,
      "modifier_percentage": 0,
      "total_amount_line": 188.25,
      "sku": "3245",
      "taxes": [
        {
               "tax_type_id":"474",
               "tax_percentage":21,
               "tax_amount":21,
               "tax_base_amount": 100
            },
            {
               "tax_type_id":"475",
               "tax_percentage":10.5,
               "tax_amount":5.25,
               "tax_base_amount": 50
            },
            {
               "tax_type_id":"484",
               "tax_percentage":8,
               "tax_amount":12,
               "tax_base_amount": 150
            }
      ]
    },
    {
      "quantity": 1,
      "line_description": "Prueba Koywe 2",
      "unit_measure": "UNI",
      "unit_price": 150,
      "long_description": "Test descripcion 2",
      "modifier_amount": 0,
      "total_taxes": 38.25,
      "modifier_percentage": 0,
      "total_amount_line": 188.25,
      "sku": "1111",
      "taxes": [
        {
               "tax_type_id":"474",
               "tax_percentage":21,
               "tax_amount":21,
               "tax_base_amount": 100
            },
            {
               "tax_type_id":"475",
               "tax_percentage":10.5,
               "tax_amount":5.25,
               "tax_base_amount": 50
            },
            {
               "tax_type_id":"484",
               "tax_percentage":8,
               "tax_amount":12,
               "tax_base_amount": 150
            }
      ]
    }
  ],
   "totals": {
    "net_amount": 300,
    "taxes_amount":76.5,
    "total_amount": 376.5
  }
}

Factura B (Factura Electrónica B)

Para emitir una Factura B argentina (comúnmente utilizada como boleta de consumidor), debes usar el endpoint /documents con los parámetros adecuados para receptores no inscriptos en el IVA. Este tipo de documento está diseñado para consumidores finales o contribuyentes que no son elegibles para el crédito fiscal del IVA, e incluye requisitos fiscales simplificados en comparación con la Factura A.

Endpoint: https://api-billing.koywe.com/V1/documents
Método: POST
Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /

{
   "header":{
     "account_id": 29240,
     "document_type_id": "115",
     "received_issued_flag": 0,
     "issue_date": "2025-10-24",
     "issuer_tax_id_code": "20357265992",
     "issuer_tax_id_type": "AR-CUIT",
     "issuer_legal_name": "Tecnologias Avanzadas S.A.",
     "issuer_address": "Av. Corrientes 1234",
     "issuer_district": "San Nicolas",
     "issuer_city": "Ciudad Autonoma de Buenos Aires",
     "issuer_department": "Buenos Aires",
     "issuer_country_id": "88",
     "issuer_phone": "011-4321-5678",
     "issuer_activity": "Servicios de desarrollo de software",
     "issuer_postalcode": "1043",
     "receiver_tax_id_code": "30274688781",
     "receiver_tax_id_type": "AR-CUIT",
     "receiver_legal_name": "ESCUELA KEMPER URGATES",
     "receiver_address": "Calle Belgrano 456",
     "receiver_district": "Centro",
     "receiver_city": "Cordoba",
     "receiver_department": "Cordoba",
     "receiver_country_id": "88",
     "receiver_phone": "0351-487-2233",
     "receiver_activity": "Servicios educativos",
     "receiver_postalcode": "5000",
     "payment_conditions": "0",
     "currency_id": 1,
     "branch_office_code": 12,
      "additional":{
         "ar_header":{
            "invoice_concept": 1,
            "items_quantity": 1,
            "service_date_from": "2025-10-14",
            "service_date_to": "2025-10-14",
            "service_payment_due_date": "2025-10-10",
            "receiver_vat_condition_id": 1
         }
      }
   },
   "details": [
    {
      "quantity": 1,
      "line_description": "Prueba Koywe",
      "unit_measure": "UNI",
      "unit_price": 150,
      "long_description": "Test descripcion",
      "modifier_amount": 0,
      "total_taxes": 38.25,
      "modifier_percentage": 0,
      "total_amount_line": 188.25,
      "sku": "3245",
      "taxes": [
        {
               "tax_type_id":"474",
               "tax_percentage":21,
               "tax_amount":21,
               "tax_base_amount": 100
            },
            {
               "tax_type_id":"475",
               "tax_percentage":10.5,
               "tax_amount":5.25,
               "tax_base_amount": 50
            },
            {
               "tax_type_id":"484",
               "tax_percentage":8,
               "tax_amount":12,
               "tax_base_amount": 150
            }
      ]
    },
    {
      "quantity": 1,
      "line_description": "Prueba Koywe 2",
      "unit_measure": "UNI",
      "unit_price": 150,
      "long_description": "Test descripcion 2",
      "modifier_amount": 0,
      "total_taxes": 38.25,
      "modifier_percentage": 0,
      "total_amount_line": 188.25,
      "sku": "1111",
      "taxes": [
        {
               "tax_type_id":"474",
               "tax_percentage":21,
               "tax_amount":21,
               "tax_base_amount": 100
            },
            {
               "tax_type_id":"475",
               "tax_percentage":10.5,
               "tax_amount":5.25,
               "tax_base_amount": 50
            },
            {
               "tax_type_id":"484",
               "tax_percentage":8,
               "tax_amount":12,
               "tax_base_amount": 150
            }
      ]
    }
  ],
   "totals": {
    "net_amount": 300,
    "taxes_amount":76.5,
    "total_amount": 376.5
  }
}

Factura C (Factura Electrónica C)

Para emitir una Factura C argentina, debes usar el endpoint /documents con los parámetros correspondientes a los contribuyentes inscriptos bajo el régimen de Monotributo. Este tipo de documento excluye los cálculos de IVA y está destinado a monotributistas, requiriendo un desglose fiscal mínimo y manteniendo el pleno cumplimiento con los estándares de facturación electrónica de ARCA.

Endpoint: https://api-billing.koywe.com/V1/documents
Método: POST
Cabeceras requeridas:
- Content-Type: application/json
- Authorization: Bearer \<token>
- Accept: /

{
   "header":{
     "account_id": 29240,
     "document_type_id": "119",
     "received_issued_flag": 0,
     "issue_date": "2025-10-24",
     "issuer_tax_id_code": "20357265992",
     "issuer_tax_id_type": "AR-CUIT",
     "issuer_legal_name": "Tecnologias Avanzadas S.A.",
     "issuer_address": "Av. Corrientes 1234",
     "issuer_district": "San Nicolas",
     "issuer_city": "Ciudad Autonoma de Buenos Aires",
     "issuer_department": "Buenos Aires",
     "issuer_country_id": "88",
     "issuer_phone": "011-4321-5678",
     "issuer_activity": "Servicios de desarrollo de software",
     "issuer_postalcode": "1043",
     "receiver_tax_id_code": "30274688781",
     "receiver_tax_id_type": "AR-CUIT",
     "receiver_legal_name": "ESCUELA KEMPER URGATES",
     "receiver_address": "Calle Belgrano 456",
     "receiver_district": "Centro",
     "receiver_city": "Cordoba",
     "receiver_department": "Cordoba",
     "receiver_country_id": "88",
     "receiver_phone": "0351-487-2233",
     "receiver_activity": "Servicios educativos",
     "receiver_postalcode": "5000",
     "payment_conditions": "0",
     "currency_id": 1,
     "branch_office_code": 12,
      "additional":{
         "ar_header":{
            "invoice_concept": 1,
            "items_quantity": 1,
            "service_date_from": "2025-10-17",
            "service_date_to": "2025-10-17",
            "service_payment_due_date": "2025-10-17",
            "receiver_vat_condition_id": 7
         }
      }
   },
   "details": [
    {
      "quantity": 1,
      "line_description": "Prueba Koywe",
      "unit_measure": "UNI",
      "unit_price": 100,
      "long_description": "Test descripcion",
      "modifier_amount": 0,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 100,
      "sku": "3245"
    }
  ],
   "totals":{
      "net_amount":100,
      "non_taxed_amount":0,
      "exempt_amount":0,
      "vat_amount":0,
      "other_taxes_amount":0,
      "total_amount":100
   }
}

Factura E (Factura Electrónica de Exportación)

Para emitir una Factura E argentina en operaciones de exportación, debes usar el endpoint /documents con los parámetros requeridos para transacciones internacionales. Este tipo de documento se utiliza exclusivamente para bienes o servicios vendidos al exterior y está exento del IVA. Requiere información detallada sobre la identificación fiscal extranjera del comprador, especificaciones de moneda, destino de exportación y datos aduaneros, de acuerdo con las regulaciones de comercio exterior de AFIP.

Endpoint: https://api-billing.koywe.com/V1/documents
Método: POST
Cabeceras requeridas:
Content-Type: application/json
Authorization: Bearer \<token>
Accept: /

{
   "header":{
      "account_id": 29240,
      "document_type_id": "123",
      "received_issued_flag": 0,
      "issue_date": "2025-10-24",
      "issuer_tax_id_code": "20357265992",
      "issuer_tax_id_type": "AR-CUIT",
      "issuer_legal_name": "Tecnologias Avanzadas S.A.",
      "issuer_address": "Av. Corrientes 1234",
      "issuer_district": "San Nicolas",
      "issuer_city": "Ciudad Autonoma de Buenos Aires",
      "issuer_department": "Buenos Aires",
      "issuer_country_id": "88",
      "issuer_phone": "011-4321-5678",
      "issuer_activity": "Servicios de desarrollo de software",
      "issuer_postalcode": "1043",
      "receiver_tax_id_code": "30274688781",
      "receiver_tax_id_type": "AR-CUIT",
      "receiver_legal_name": "ESCUELA KEMPER URGATES",
      "receiver_address": "Calle Belgrano 456",
      "receiver_district": "Centro",
      "receiver_city": "Cordoba",
      "receiver_department": "Cordoba",
      "receiver_country_id": "88",
      "receiver_phone": "0351-487-2233",
      "receiver_activity": "Servicios educativos",
      "receiver_postalcode": "5000",
      "payment_conditions": "0",
      "currency_id": 1,
      "branch_office_code": 12,
      "additional":{
         "ar_header":{
            "invoice_concept": 1,
            "items_quantity": 1,
            "service_date_from": "2025-10-20",
            "service_date_to": "2025-10-20",
            "service_payment_due_date": "2025-10-20",
            "receiver_vat_condition_id": 9,
            "existing_permission": "N",
            "language_code": 1
         }
      }
   },
   "details": [
    {
      "quantity": 1,
      "line_description": "Prueba Koywe",
      "unit_measure": "UN",
      "unit_price": 5000,
      "long_description": "Test descripcion",
      "modifier_amount": 0,
      "total_taxes": 0,
      "modifier_percentage": 0,
      "total_amount_line": 5000,
      "sku": "3245"
    }
  ],
   "totals":{
      "net_amount":5000,
      "non_taxed_amount":0,
      "exempt_amount":0,
      "vat_amount":0,
      "other_taxes_amount":0,
      "total_amount":5000
   }
}

Nota de crédito A con referencia de reference_document_id

Los parámetros del receptor son obligatorios para la nota de crédito. Para emitir una Nota de Crédito A argentina, debes usar el endpoint /documents con los parámetros correspondientes y la referencia a la Factura A original que se está ajustando.