Skip to content
FacttecFacttec Developers

Pruebas

Recursos orientados a pruebas y validación del ambiente.

4 operaciones documentadas.

Prueba2

Section titled “Prueba2”

POSThttps://api.facttec.co/api/ubl2.1/invoice-aiu

  • Aplica la misma documentacion que el PRIMER ENVIO DE FACTURA de la sección 02 - PRIMEROS ENVIOS.

  • Este ejemplo ilustra como se debe utilizar la API para enviar una factura AIU, este tipo de factura tiene como caracteristica que incluye las lineas ADMINISTRACION, IMPREVISTO y UTILIDAD, pero solo se cobra impuesto sobre el campo UTILIDAD, es muy utilizada por contratistas del area de la construccion.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "number": 990000378,
  "dv": 2,
  "type_document_id": 1,
  "date": "2021-08-17",
  "time": "09:44:45",
  "notes": "SIN OBSERVACIONES",
  "noteAIU": "PRUEBA DE CONTRATO AIU",
  "resolution_number": "18760000001",
  "prefix": "SETP",
  "customer": {
    "identification_number": 89008003,
    "name": "ALEXANDER OBANDO LONDONO",
    "phone": 3103891693,
    "address": "BRR LIMONAR MZ 6 CS 3 ET 1",
    "email": "alexander_obando@hotmail.com",
    "merchant_registration": "0000-00",
    "type_document_identification_id": 3,
    "type_organization_id": 2,
    "municipality_id": 149,
    "type_regime_id": 2
  },
  "sendmail": true,
  "foot_note": "Generado por SKALA Platform | NIT 901.450.277 - 1 | Cel: 300 2031148 - www.skala.one",
  "tax_totals": [
    {
      "tax_id": 1,
      "percent": "19.00",
      "tax_amount": "91187.27",
      "taxable_amount": "479933.00"
    },
    {
      "tax_id": 1,
      "percent": "0.00",
      "tax_amount": "0.00",
      "taxable_amount": "10174570.59"
    }
  ],
  "payment_form": {
    "payment_form_id": 2,
    "duration_measure": 13,
    "payment_due_date": "2021-09-15",
    "payment_method_id": 75
  },
  "sendmailtome": true,
  "invoice_lines": [
    {
      "code": "1",
      "tax_totals": [
        {
          "tax_id": 1,
          "percent": "0.00",
          "tax_amount": "0.00",
          "taxable_amount": "9598650.59"
        }
      ],
      "description": "Instalaciones Generales Con AIU",
      "price_amount": "8199.98",
      "base_quantity": "1170.57",
      "unit_measure_id": 70,
      "allowance_charges": [
        {
          "amount": "0.00",
          "base_amount": "9598650.59",
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL"
        }
      ],
      "invoiced_quantity": "1170.57",
      "line_extension_amount": "9598650.59",
      "free_of_charge_indicator": false,
      "type_item_identification_id": 4
    },
    {
      "code": "2",
      "tax_totals": [
        {
          "tax_id": 1,
          "percent": "0.00",
          "tax_amount": "0.00",
          "taxable_amount": "287960.00"
        }
      ],
      "description": "Administración",
      "price_amount": "287960.00",
      "base_quantity": "1.00",
      "unit_measure_id": 70,
      "allowance_charges": [
        {
          "amount": "0.00",
          "base_amount": "287960.00",
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL"
        }
      ],
      "invoiced_quantity": "1.00",
      "line_extension_amount": "287960.00",
      "free_of_charge_indicator": false,
      "type_item_identification_id": 4
    },
    {
      "code": "3",
      "tax_totals": [
        {
          "tax_id": 1,
          "percent": "0.00",
          "tax_amount": "0.00",
          "taxable_amount": "287960.00"
        }
      ],
      "description": "Imprevisto",
      "price_amount": "287960.00",
      "base_quantity": "1.00",
      "unit_measure_id": 70,
      "allowance_charges": [
        {
          "amount": "0.00",
          "base_amount": "287960.00",
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL"
        }
      ],
      "invoiced_quantity": "1.00",
      "line_extension_amount": "287960.00",
      "free_of_charge_indicator": false,
      "type_item_identification_id": 4
    },
    {
      "code": "4",
      "tax_totals": [
        {
          "tax_id": 1,
          "percent": "19.00",
          "tax_amount": "91187.27",
          "taxable_amount": "479933.00"
        }
      ],
      "description": "Utilidad",
      "price_amount": "571120.27",
      "base_quantity": "1.00",
      "unit_measure_id": 70,
      "allowance_charges": [
        {
          "amount": "0.00",
          "base_amount": "479933.00",
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL"
        }
      ],
      "invoiced_quantity": "1.00",
      "line_extension_amount": "479933.00",
      "free_of_charge_indicator": false,
      "type_item_identification_id": 4
    }
  ],
  "allowance_charges": [
    {
      "amount": "0.00",
      "base_amount": "10654503.59",
      "discount_id": 10,
      "charge_indicator": false,
      "allowance_charge_reason": "DESCUENTO GENERAL"
    }
  ],
  "establishment_name": "COSTA VERTICAL SOLUTION S.A.S",
  "legal_monetary_totals": {
    "payable_amount": "10745690.86",
    "charge_total_amount": "0.00",
    "tax_exclusive_amount": "10654503.59",
    "tax_inclusive_amount": "10745690.86",
    "line_extension_amount": "10654503.59",
    "allowance_total_amount": "0.00"
  }
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/invoice-aiu' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": 990000378,
  "dv": 2,
  "type_document_id": 1,
  "date": "2021-08-17",
  "time": "09:44:45",
  "notes": "SIN OBSERVACIONES",
  "noteAIU": "PRUEBA DE CONTRATO AIU",
  "resolution_number": "18760000001",
  "prefix": "SETP",
  "customer": {
    "identification_number": 89008003,
    "name": "ALEXANDER OBANDO LONDONO",
    "phone": 3103891693,
    "address": "BRR LIMONAR MZ 6 CS 3 ET 1",
    "email": "alexander_obando@hotmail.com",
    "merchant_registration": "0000-00",
    "type_document_identification_id": 3,
    "type_organization_id": 2,
    "municipality_id": 149,
    "type_regime_id": 2
  },
  "sendmail": true,
  "foot_note": "Generado por SKALA Platform | NIT 901.450.277 - 1 | Cel: 300 2031148 - www.skala.one",
  "tax_totals": [
    {
      "tax_id": 1,
      "percent": "19.00",
      "tax_amount": "91187.27",
      "taxable_amount": "479933.00"
    },
    {
      "tax_
…'

Prueba3

Section titled “Prueba3”

POSThttps://api.facttec.co/api/ubl2.1/status/zip/e0f6f102-2769-4b98-a566-2a16518f23ed

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al zip_key que el response del envio de un documento electrónico en modo asíncrono retorno.

https://api.facttec.co/api/ubl2.1/invoice/status/zip/codigodelzip_key

  • El response de este endpoint muestra si el documento electrónico fue valido o si fue rechazado, en cuyo caso mostrara las reglas de validación por las cuales se rechazo.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "sendmail": false,
  "sendmailtome": false,
  "atacheddocument_name_prefix": "NIS-A1-"
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/status/zip/e0f6f102-2769-4b98-a566-2a16518f23ed' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "sendmail": false,
  "sendmailtome": false,
  "atacheddocument_name_prefix": "NIS-A1-"
}'

Prueba1

Section titled “Prueba1”

POSThttps://api.facttec.co/api/ubl2.1/invoice

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al id del set de pruebas que la dian entregó al momento de registrar el modo de operación software propio.

https://api.facttec.co/api/ubl2.1/invoice/iddelsetdepruebasdeladian

  • Este endpoint se puede utilizar de dos modos:

  1. asíncrono: https://api.facttec.co/api/ubl2.1/invoice/iddelsetdepruebasdeladian

  2. síncrono: https://api.facttec.co/api/ubl2.1/invoice

  • El modo síncrono no afecta al set de pruebas, pero la respuesta de la DIAN incluye posibles errores de validación y estado de la factura, válida o no válida.

  • El modo asíncrono, afecta el set de pruebas y en la respuesta no se incluye el resultado de la factura, solo se entrega un ZIP_KEY el cual debe ser consultado mediante el endpoint:

https://api.facttec.co/api/ubl2.1/status/zip

de la sección 03 - Consultas de estado para asi poder establecer si la factura fue válida o no y los errores de validación.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "number": 990001148,
  "type_document_id": "1",
  "tarifaica": "0",
  "actividadeconomica": "6201",
  "date": "2024-10-03",
  "time": "21:15:11",
  "resolution_number": "18760000001",
  "establishment_name": "TORRE SOFTWARE",
  "prefix": "SETP",
  "sendmail": false,
  "notes": "Numero de Orden 48037 Fecha de Venta 20240802 211510",
  "payment_form": {
    "payment_form_id": "2",
    "payment_method_id": "10",
    "payment_due_date": "2024-10-03",
    "duration_measure": "0"
  },
  "customer": {
    "identification_number": "890001254",
    "name": "ESTRUCTURAS COYABRA SAS",
    "phone": "3116109981",
    "address": "CLL 11 NRO 21-73",
    "type_document_identification_id": 6,
    "type_regime_id": 2,
    "type_organization_id": 1,
    "municipality_id": 820,
    "dv": 8,
    "email": "coyabra.secretaria@gmail.com"
  },
  "order_reference": {
    "id_order": "A23061977FBC",
    "issue_date_order": "2020-10-01"
  },
  "allowance_charges": [
    {
      "discount_id": 1,
      "charge_indicator": false,
      "allowance_charge_reason": "DESCUENTO GENERAL",
      "amount": "50000.00",
      "base_amount": "1000000.00"
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "840336.134",
    "tax_exclusive_amount": "840336.134",
    "tax_inclusive_amount": "1000000.00",
    "allowance_total_amount": "50000.00",
    "payable_amount": "950000.00"
  },
  "with_holding_tax_total": [
    {
      "tax_id": 5,
      "tax_amount": "126050.042",
      "percent": "15",
      "taxable_amount": "840336.13"
    },
    {
      "tax_id": 6,
      "tax_amount": "29411.76",
      "percent": "3.50",
      "taxable_amount": "840336.13"
    }
  ],
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "159663.865",
      "percent": "19",
      "taxable_amount": "840336.134"
    }
  ],
  "invoice_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "840336.134",
      "free_of_charge_indicator": false,
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "159663.865",
          "taxable_amount": "840336.134",
          "percent": "19.00"
        }
      ],
      "description": "COMISION POR SERVICIOS",
      "notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
      "code": "COMISION",
      "type_item_identification_id": 4,
      "price_amount": "1000000.00",
      "base_quantity": "1"
    }
  ],
  "logo_empresa_emisora": "/9j/4AAQSkZJRgABAQEAYABgAAD/4QBaRXhpZgAATU0AKgAAAAgABQMBAAUAAAABAAAASgMDAAEAAAABAAAAAFEQAAEAAAABAQAAAFERAAQAAAABAAAOw1ESAAQAAAABAAAOwwAAAAAAAYagAACxj//bAEMAAgEBAgEBAgICAgICAgIDBQMDAwMDBgQEAwUHBgcHBwYHBwgJCwkICAoIBwcKDQoKCwwMDAwHCQ4PDQwOCwwMDP/bAEMBAgICAwMDBgMDBgwIBwgMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDP/AABEIAC4AdgMBIgACEQEDEQH/xAAfAAABBQEBAQEBAQAAAAAAAAAAAQIDBAUGBwgJCgv/xAC1EAACAQMDAgQDBQUEBAAAAX0BAgMABBEFEiExQQYTUWEHInEUMoGRoQgjQrHBFVLR8CQzYnKCCQoWFxgZGiUmJygpKjQ1Njc4OTpDREVGR0hJSlNUVVZXWFlaY2RlZmdoaWpzdHV2d3h5eoOEhYaHiImKkpOUlZaXmJmaoqOkpaanqKmqsrO0tba3uLm6wsPExcbHyMnK0tPU1dbX2Nna4eLj5OXm5+jp6vHy8/T19vf4+fr/xAAfAQADAQEBAQEBAQEBAAAAAAAAAQIDBAUGBwgJCgv/xAC1EQACAQIEBAMEBwUEBAABAncAAQIDEQQFITEGEkFRB2FxEyIygQgUQpGhscEJIzNS8BVictEKFiQ04SXxFxgZGiYnKCkqNTY3ODk6Q0RFRkdISUpTVFVWV1hZWmNkZWZnaGlqc3R1dnd4eXqCg4SFhoeIiYqSk5SVlpeYmZqio6Slpqeoqaqys7S1tre4ubrCw8TFxsfIycrS09TV1tfY2dri4+Tl5ufo6ery8/T19vf4+fr/2gAMAwEAAhEDEQA/AP38qn4h8QWfhXQ7rUr+Zbezs4zLLI38Kj+vt3NXK8F/4KP+Jbzwz+zVNJa+YVudStoJwo6oSzD/AMfVKzqRrSg44ZXnZ8qezfS/zPH4hzeOV5ZXzGauqUXK3ov6uDfFfxZ8YrK61HSb6x8J+F4ZDEL27lEJk/4Gcnd7LgDpk0sGreOvCGmtq2leJdO8Zaba/Ncxwyi4aNfUj7wH+6cjrjFeKDxHY618dPhr4E8TXFxo/hmLQrKVYJibbzp5rbzW3ZwVZ5j5Z75GBg817L8SP2bvEPgnxlp+r/C1k03dE8d3BLdZRDxggSbtwbJypyAVBr8LzPgXiCE3jKletOppeca0ozTet6dJJUnCL05H8Sv7yvp8VlPElTMKVXEUYyn7KShPlb51KybtDblV9LvVJv09h+HHj60+JPhS31S1Bj8zKSxE5aGQdVP6EHuCDW9XhvwM0bxB+z/pfifVvHUunaboCwfbprlJQ0dsUJ3sVQfKu05OBgBRXe+Av2jPA/xP8Iap4g0HxNpeo6JopYX18khWC1KrvO5mAAwpBPoCK/WuE62Z4nKaVbNKbjWStPSyck7X7LmVpW6Xstj7XA5tSqQhHEPkqNN8srRlZbvlettL32O1or5Z1r/gsX8FNH8Qy2K6jr19HDIYzeW2mM1u2DjILEMR7hea9mtf2pvh9efCCPx9H4p03/hEZHEX9pEsI43LbNjjG5G3YGGAPI9RX1FTA4inZzg1fbRnPguKsmxcpxw2KpycE3K01olu3rsur28z0CivIbn9vj4PWWn213N490WG1vd32eZ/MWOfacNsYrhtp4OOhosP2+fg3qd/a2sPxC8PtNfOscAaVlEhZtowSoGN3Gc44NT9Tr/yP7mbf6yZTe31qnf/ABx67dep69RXD/Fv9pPwH8B7uyt/GHijStAn1FGkto7qQh5VUgFgACcZIGT159DWtb/FvwzP4At/FT65p1p4buoxNFqN5KLW3dD91t0m0bW6gngggjIINZ+xnZSs7PbTc7lmOEdWdFVY88FeS5leK7tXul6nRUV5j4R/bO+Fnj7xna+HdD8caFq2s30hit7a0mMrTMAWO0qMHABOQcYFenUVKc4O00166FYTHYbFRc8LUjNJ2bi1JJ9tG9QooorM6gpk1vHcqFkjSRVYMAy5wQcg/UHmn18sf8Fjbfx1Y/sR6x4i+H+seINH1fwfdw6zdnR72W1uLixRXSdSY2BKIsnnMDxiDPUCtKMOeai3a/U8/NsZLCYOpiYwc+RN8q3duiPQ/wBrn9jTQv2q9AhaaZtJ8SafGUsdTjTdheT5Uq/xx5JOMgqSSDywPz7+zn+0j8RP2UvjnpHwl+LCvd6Xq0iWukam8nm+XubZEY5f+WkLNhSH+ZMj7oG2vlz9nv4o/GKx+Engb48fDHxt4w+Nlvp8stv4x8K3F3cXVxos23a0bwCV3kjdWZ1kC5UbHx1x13ir47fED9un4zeGfHvjrwfN8JfhT8OZhd3mpasskEUMYkSSVUllRDcXEhjSNI4kJBK8dSfpsLpTeGryU6dn6xfS3Xf5P8/58zzGRq42nn2VUKmGzByhdR1p16T5eZ1ZL3LRje7bUota7Xj+gv7c3/JnXxM/7F28/wDRTV+df7P3gnxL4+/4JW/E6z8M29xeTw+KoLq9toAWlntY4YWkCgcnaQrkDshr6mf9tnT/ANuP9gD4yeINJ8O6toen6Xpd5YpNdujx3beSzEIV/iVShYYwPMABPOPHP+Cb7/EC3/YB+JFx8MZo4/GFn4hWe0R4Y5TcIsEBkjVZAVLlN23I5IA71OXxnRwslKyanHfbpuz1eLMRhM3z2hUoOU6VTC17OCfM1aS92MrXfZO19up86fA34r/BXRfhBfeHPHnw51nUNdvJJMeI9Nv83NsrD5DHC7KgKf3SSH7+le5eJvh98PfCP/BL74hah8OfF+teJtM1jVtMN5balCkE2m3Ec6AgxqAQWVlycspCDB4Ncb40/a7j1L9naeH4kfCrwn4m8b6xqGp6WNYutPj0u+sJIo7aQO6wxI7MDdYwGjP7sEkkmqXgT4GeKPhv/wAE2vit4i12xvdL0/xPf6MmnW9yhjecQ3Tb5th5CnzAFPG7BPIwa9qqm7Tk3H346c11LVbdVb5eh+X5fUhTVTC0IwrKOGq3mqTp1KSdKTXtLe7Jyuk23PV/Fffkvhr45+B+vfBrQNF+JEfxWXWdAmu/Kfw0tgLV4ppA43G4JYsMdgB9a+kv2pP+Cevh3Xf2EfB/i74aw69eS6DpY1eJdU8uTULvTLrN20cnlAJvhMzOAoPBkGW4Nbv/AATE/Ys+F/x1/ZVs9e8WeEbPWNXbUbqA3Mk80bFFYbQQjqOMnnGa+y/G3hix8E/s/avoul262emaR4emsrOBSWWGGO2ZEQEkk4VQOSTxXk5hmip4lQoOV4yd09vl97P0Tg7w/ljckniM1jScK1CKhKCaqKyTi5Nq11yx2vt2PzU/Yz+B/wDw8W+KGg6t4q1i4vP+EDtrez162upHkbUbSMH7GIichdxV0lGR93eNzSsV1P2tn8Qft2/8FCrf4R6ffR6R4d8N3D6ZaRIN1vZrDEXuLgxggF/lZAOOFRcjk103/BBj/kbPiV/16WH/AKHPTP2/f2e/iF+zD+1mvxw+HlneahY3UwvriWGDzxp9yy+VLHNGvPkyqfvesjKSDtJ7JVrZhOjdJxjaF9k2k/68tD53D5a6vBmGzJ05TjVrKWJ5buc6cJSj62Vk3/efNpufQH7PX/BJbwD+zx8S9B8YWGveMNQ1zQnaRBcT262srNG0ZzGsO8DDnjf1xya+pq+Ff2UP+Cu2uftCfHHwx4H1DwXpemza3M8M97DfSMIykbyErEy552YwXOM55xivuqvmczhio1EsW/etps9Pkfu3AeK4er4GcuHIqNJStKykve5Y3vzat2trt5hRRRXmn2wU24gju4HiljWSORSjo43K4PBBHcGnUUAfnL8cv+CBp0D4rXfjj9nX4oa58F9WvizT6bbPMLLLHJWGSF0kiiP/ADyYSLzgbVAUc5oP/BBr4nfHHxFp958f/wBorxL4y03TZQ6aXZS3Fzkd9k1y+2EkcErCSc9a/T2iulYuquv+f3nzNTg/Kqkm5U/dbu4qUlFv/Cnb5Wt5HMfDD4M+F/g18NNN8H+G9FstL8N6TCIbaxRN0ajO4lt2S7FssWYlmYkkknNb9hpFppW77La29t5mN3lRBN2OmcD3P51YorByb3PoqdGnBKMIpJKystl2XZFG78M6bqGpR3lxp9jNeQ8RzyQK0kf0YjI6Dp6VYvtNt9UhEd1bw3EancFlQOoPrg/U1NWf4a8J6X4L06Sz0fTNP0mzmu7m/kgs7dII3uLmeS4uJiqgAySzyyyu55eSR2YlmJKuyvZx10338y1Y6bb6XCY7W3ht42O4rEgRSfXA+gqSaFbiFo5FWSOQFWVhlWB6ginUUh8qSsirY6FY6XMZLWztbeRhtLRQqjEemQPYVaoooFGKirJFNvD2nvefaGsbNrjcH80wrv3DvnGc+9XKKKLsIxS2QUUUUFH/2Q=="
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/invoice' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "number": 990001148,
  "type_document_id": "1",
  "tarifaica": "0",
  "actividadeconomica": "6201",
  "date": "2024-10-03",
  "time": "21:15:11",
  "resolution_number": "18760000001",
  "establishment_name": "TORRE SOFTWARE",
  "prefix": "SETP",
  "sendmail": false,
  "notes": "Numero de Orden 48037 Fecha de Venta 20240802 211510",
  "payment_form": {
    "payment_form_id": "2",
    "payment_method_id": "10",
    "payment_due_date": "2024-10-03",
    "duration_measure": "0"
  },
  "customer": {
    "identification_number": "890001254",
    "name": "ESTRUCTURAS COYABRA SAS",
    "phone": "3116109981",
    "address": "CLL 11 NRO 21-73",
    "type_document_identification_id": 6,
    "type_regime_id": 2,
    "type_organization_id": 1,
    "municipality_id": 820,
    "dv": 8,
    "email": "coyabra.secretaria@gmail.com"
  },
  "order_reference": {
    "id_order": "A23061977FBC",
    "issue
…'

Nota crédito ICL

Section titled “Nota crédito ICL”

POSThttps://api.facttec.co/api/ubl2.1/credit-note

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • Requiere un token de autorización el cual fue devuelto al realizar el Paso 1 — Configurar empresa, si lo extraviaste, puedes consultarlo o regenerarlo desde el panel admin de Facttec.

  • En URL el último parametro corresponde al id del set de pruebas que la dian entregó al momento de registrar el modo de operación software propio.

https://api.facttec.co/api/ubl2.1/invoice/iddelsetdepruebasdeladian

  • Este endpoint se puede utilizar de dos modos:

  1. asíncrono: https://api.facttec.co/api/ubl2.1/invoice/iddelsetdepruebasdeladian

  2. síncrono: https://api.facttec.co/api/ubl2.1/invoice

  • El modo síncrono no afecta al set de pruebas, pero la respuesta de la DIAN incluye posibles errores de validación y estado de la factura, válida o no válida.

  • El modo asíncrono, afecta el set de pruebas y en la respuesta no se incluye el resultado de la factura, solo se entrega un ZIP_KEY el cual debe ser consultado mediante el endpoint:

https://api.facttec.co/api/ubl2.1/status/zip

de la sección 03 - Consultas de estado para asi poder establecer si la factura fue válida o no y los errores de validación.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "billing_reference": {
    "number": "SETP990001109",
    "uuid": "858813ba65240e31fc5f808ff51465f605a0c143d6c50a324b6c89978db8fcd93660f6b5eeb4fb61229d627b40334bb4",
    "issue_date": "2024-06-28"
  },
  "discrepancyresponsecode": 2,
  "discrepancyresponsedescription": null,
  "notes": "Devolución Contado Automatico  a documento SETP990001109",
  "prefix": "NC",
  "number": 95,
  "type_document_id": 4,
  "date": "2024-06-28",
  "time": "06:00:13",
  "establishment_name": "TORRE SOFTWARE",
  "establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
  "establishment_phone": "3226563672",
  "establishment_municipality": 600,
  "sendmail": false,
  "sendmailtome": false,
  "head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
  "foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
  "customer": {
    "identification_number": 900166483,
    "dv": 1,
    "name": "INVERSIONES DAVAL SAS",
    "phone": "3103891693",
    "address": "CLL 4 NRO 33-90",
    "email": "alexanderobandolondono@gmail.com",
    "merchant_registration": "0000000-00",
    "type_document_identification_id": 6,
    "type_organization_id": 1,
    "municipality_id": 822,
    "type_regime_id": 1
  },
  "legal_monetary_totals": {
    "line_extension_amount": "17820.00",
    "tax_exclusive_amount": "17820.00",
    "tax_inclusive_amount": "33245.00",
    "allowance_total_amount": null,
    "charge_total_amount": null,
    "payable_amount": "33245.00"
  },
  "type_operation_id": null,
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "891.00",
      "percent": "5.00",
      "taxable_amount": "17820.00",
      "unit_measure_id": null,
      "per_unit_amount": null,
      "base_unit_measure": null
    },
    {
      "tax_id": 19,
      "tax_amount": "14534.00",
      "percent": "0",
      "taxable_amount": "0",
      "unit_measure_id": "70",
      "per_unit_amount": null,
      "base_unit_measure": null
    }
  ],
  "credit_note_lines": [
    {
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "891.0000",
          "percent": "5.00",
          "taxable_amount": "17820.00",
          "unit_measure_id": null,
          "per_unit_amount": null,
          "base_unit_measure": null
        },
        {
          "tax_id": 19,
          "tax_amount": "14534.00",
          "percent": "0",
          "taxable_amount": "0",
          "unit_measure_id": "70",
          "per_unit_amount": "1.00",
          "base_unit_measure": "14534"
        }
      ],
      "unit_measure_id": 1076,
      "invoiced_quantity": "1.00",
      "line_extension_amount": "17820.00",
      "free_of_charge_indicator": false,
      "description": "LDM AGUARDIENTE CAÑO CRISTALES 750 CC BOTELLA  ",
      "notes": "",
      "code": "LDM001005",
      "type_item_identification_id": 4,
      "price_amount": "17820.00",
      "base_quantity": "1"
    }
  ]
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/credit-note' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "billing_reference": {
    "number": "SETP990001109",
    "uuid": "858813ba65240e31fc5f808ff51465f605a0c143d6c50a324b6c89978db8fcd93660f6b5eeb4fb61229d627b40334bb4",
    "issue_date": "2024-06-28"
  },
  "discrepancyresponsecode": 2,
  "discrepancyresponsedescription": null,
  "notes": "Devolución Contado Automatico  a documento SETP990001109",
  "prefix": "NC",
  "number": 95,
  "type_document_id": 4,
  "date": "2024-06-28",
  "time": "06:00:13",
  "establishment_name": "TORRE SOFTWARE",
  "establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
  "establishment_phone": "3226563672",
  "establishment_municipality": 600,
  "sendmail": false,
  "sendmailtome": false,
  "head_note": "PRUEBA DE TEXTO LIBRE QUE DEBE POSICIONARSE EN EL ENCABEZADO DE PAGINA DE LA REPRESENTACION GRAFICA DE LA FACTURA ELECTRONICA VALIDACION PREVIA DIAN",
  "foot_note": "PRUEBA DE TEXTO LIBRE QUE DEBE PO
…'