Skip to content
FacttecFacttec Developers

Planes

Planes, cupos y administración comercial de la API.

7 operaciones documentadas.

Crear Plan

Section titled “Crear Plan”

PUThttps://api.facttec.co/api/ubl2.1/plan

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "id": "2",
  "name": "PLAN DE PRUEBA 2",
  "qty_docs_invoice": 15,
  "qty_docs_payroll": 5,
  "qty_docs_radian": 10,
  "qty_docs_ds": 5,
  "period": 1,
  "observation": "NINGUNA"
}
Ejemplo cURL
Terminal window
curl -X PUT 'https://api.facttec.co/api/ubl2.1/plan' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "2",
  "name": "PLAN DE PRUEBA 2",
  "qty_docs_invoice": 15,
  "qty_docs_payroll": 5,
  "qty_docs_radian": 10,
  "qty_docs_ds": 5,
  "period": 1,
  "observation": "NINGUNA"
}'

Modificar Plan

Section titled “Modificar Plan”

PUThttps://api.facttec.co/api/ubl2.1/plan

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "id": "1",
  "qty_docs_invoice": 3,
  "qty_docs_payroll": 0,
  "period": 1,
  "state": 1,
  "observation": "NINGUNA"
}
Ejemplo cURL
Terminal window
curl -X PUT 'https://api.facttec.co/api/ubl2.1/plan' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "1",
  "qty_docs_invoice": 3,
  "qty_docs_payroll": 0,
  "period": 1,
  "state": 1,
  "observation": "NINGUNA"
}'

Consultar Planes

Section titled “Consultar Planes”

GEThttps://api.facttec.co/api/ubl2.1/plan/query

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Authorization Bearer {api_token}
Ejemplo cURL
Terminal window
curl -X GET 'https://api.facttec.co/api/ubl2.1/plan/query' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}'

Informacion del Plan

Section titled “Informacion del Plan”

GEThttps://api.facttec.co/api/ubl2.1/plan/infoplanuser

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Authorization Bearer {api_token}
Ejemplo cURL
Terminal window
curl -X GET 'https://api.facttec.co/api/ubl2.1/plan/infoplanuser' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}'

Consultar Plan

Section titled “Consultar Plan”

GEThttps://api.facttec.co/api/ubl2.1/plan/query/1

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Authorization Bearer {api_token}
Ejemplo cURL
Terminal window
curl -X GET 'https://api.facttec.co/api/ubl2.1/plan/query/1' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}'

Consultar Usuarios Segun Plan

Section titled “Consultar Usuarios Segun Plan”

GEThttps://api.facttec.co/api/ubl2.1/plan/queryusersbyplan/1

  • 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.

  • Este endpoint no tiene parámetros en la URL.

  • El campo id, corresponde al id de software que entrega la DIAN al momento de registrarse como facturador electrónico y agregar modo de operación software propio.

  • El campo pin, corresponde al pin del software propio, este pin corresponde a un número de 5 digitos que nosotros mismos escogimos al registrar dicho software.

Headers

Header Valor
Accept application/json
Authorization Bearer {api_token}
Ejemplo cURL
Terminal window
curl -X GET 'https://api.facttec.co/api/ubl2.1/plan/queryusersbyplan/1' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}'

Asignar/Modificar/Renovar Plan/Estado a Compañia

Section titled “Asignar/Modificar/Renovar Plan/Estado a Compañia”

POSThttps://api.facttec.co/api/ubl2.1/config/89008003/2

  • Usa la base URL de Facttec:

    https://api.facttec.co

  • No requiere autorización

  • En URL los ultimos dos parámetros son NIT y digito de verificacion de la empresa.

https://api.facttec.co/api/ubl2.1/config/NitEmpresa/DigitoVerificacion

  • Los datos necesarios para llenar los campos JSON cuyo nombre finalice con “_id” se encuentran en las tablas parametricas de la base de datos de la API, ejemplo:

type_liability_id, se debe especificar el id del registro correspondiente de la tabla type_liabilities de la base de datos de la API.

  • Devuelve un token en el response, si fue posible la creacion de la empresa, este token es una cadena alfanumerica en el campo API_TOKEN, este dato es necesario para utilizarlo como autorización en los siguientes endpoints de la API. Si este token se pierde, se puede recuperar consultando la tabla users de la base de datos de la API, en el campo API_TOKEN.

Headers

Header Valor
Accept application/json
Content-Type application/json
Authorization Bearer {api_token}
Body JSON 
{
  "type_document_identification_id": 3,
  "type_organization_id": 2,
  "type_regime_id": 2,
  "type_liability_id": 14,
  "type_plan_id": 1,
  "renew_plan": true,
  "business_name": "ALEXANDER OBANDO LONDONO",
  "merchant_registration": "0000000-00",
  "municipality_id": 820,
  "address": "CRA 21A NRO 11-25",
  "phone": 3103891693,
  "email": "alexander_obando@hotmail.com",
  "state": true
}
Ejemplo cURL
Terminal window
curl -X POST 'https://api.facttec.co/api/ubl2.1/config/89008003/2' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {api_token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "type_document_identification_id": 3,
  "type_organization_id": 2,
  "type_regime_id": 2,
  "type_liability_id": 14,
  "type_plan_id": 1,
  "renew_plan": true,
  "business_name": "ALEXANDER OBANDO LONDONO",
  "merchant_registration": "0000000-00",
  "municipality_id": 820,
  "address": "CRA 21A NRO 11-25",
  "phone": 3103891693,
  "email": "alexander_obando@hotmail.com",
  "state": true
}'