Saltearse al contenido
Factus API

Listar Notas Crédito

Este endpoint devuelve una lista de notas crédito que cumple con los criterios de búsqueda especificados en los filtros de búsqueda descritos abajo.

Método: GET

Endpoint 

https://api-sandbox.factus.com.co/v2/credit-notes?filter[identification]&filter[names]&filter[number]&filter[prefix]&filter[reference_code]&filter[status]

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Content-Type : application/json
Indica que los datos se envían en formato JSON.
Authorization Bearer token_de_acceso
Token de autenticación necesario para acceder al recurso. Ver Cómo generar token
Accept : application/json
Indica que la respuesta debe estar en formato JSON.
Nota: Reemplaza token_de_acceso con el token proporcionado tras autenticarte.

Filtros de Búsqueda

Sección titulada «Filtros de Búsqueda»
filter[identification]
Filtra por el número de identificación del cliente.
filter[names]
Filtra por el nombre del cliente.
filter[number]
Filtra por el número de nota crédito.
filter[prefix]
Filtra por el prefijo de nota crédito.
filter[reference_code]
Filtra por código de referencia.
filter[status]
Filtra por el estado del la nota crédito (1=validada, 0= pendiente por validar).

Respuesta del Endpoint

Sección titulada «Respuesta del Endpoint»
{
  "status": "OK",
  "message": "Solicitud exitosa",
  "data": {
    "data": [
      {
        "reference_code": "NOTA-2026-0015",
        "number": "NC208",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan trade name",
          "trade_name": "Alan trade name",
          "company": "Alan company name",
          "names": null,
          "address": "calle 1 # 1-1",
          "email": "alan.company@email.com",
          "phone": "1234567890",
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "83300.00",
        "errors": [
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada"
        ],
        "send_email": true,
        "is_validated": true,
        "validated_at": "06-03-2026 04:55:21 PM",
        "created_at": "06-03-2026 04:55:19 PM"
      },
      {
        "reference_code": "NOTA-2026-0014",
        "number": "NC207",
        "correction_concept": {
          "code": "1",
          "name": "Devolución parcial de los bienes y/o no aceptación parcial del servicio"
        },
        "operation_type": {
          "code": "22",
          "name": "Nota Crédito sin referencia a una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan trade name",
          "trade_name": "Alan trade name",
          "company": "Alan company name",
          "names": null,
          "address": "calle 1 # 2-68",
          "email": null,
          "phone": "1234567890",
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "11900.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "25-02-2026 02:40:53 PM",
        "created_at": "25-02-2026 02:40:52 PM"
      },
      {
        "reference_code": "NOTA-2026-0013",
        "number": "NC206",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "13",
            "name": "Cédula ciudadanía"
          },
          "identification": "123456789",
          "dv": null,
          "graphic_representation_name": "Alan name",
          "trade_name": null,
          "company": null,
          "names": "Alan name",
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "2",
            "name": "Persona Natural"
          },
          "municipality": null
        },
        "total": "10000.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado",
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "25-02-2026 08:47:00 AM",
        "created_at": "25-02-2026 08:46:59 AM"
      },
      {
        "reference_code": "NOTA-2026-0012",
        "number": "NC205",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan company name",
          "trade_name": null,
          "company": "Alan company name",
          "names": null,
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "13900.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado",
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "24-02-2026 09:48:18 AM",
        "created_at": "24-02-2026 09:48:17 AM"
      },
      {
        "reference_code": "NOTA-2026-0011",
        "number": "NC204",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan trade name",
          "trade_name": "Alan trade name",
          "company": "Alan company name",
          "names": null,
          "address": "calle 1 # 2-68",
          "email": null,
          "phone": "1234567890",
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "11900.00",
        "errors": [
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada",
          "Regla: CAK55, Notificación: Correo electrónico no informado"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "24-02-2026 09:44:23 AM",
        "created_at": "24-02-2026 09:44:21 AM"
      },
      {
        "reference_code": "NOTA-2026-0010",
        "number": "NC203",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "13",
            "name": "Cédula ciudadanía"
          },
          "identification": "123456789",
          "dv": null,
          "graphic_representation_name": "Alan name",
          "trade_name": null,
          "company": null,
          "names": "Alan name",
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "2",
            "name": "Persona Natural"
          },
          "municipality": null
        },
        "total": "13900.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado",
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "23-02-2026 04:49:35 PM",
        "created_at": "23-02-2026 04:49:34 PM"
      },
      {
        "reference_code": "NOTA-2026-0009",
        "number": "NC202",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan company name",
          "trade_name": null,
          "company": "Alan company name",
          "names": null,
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "12700.00",
        "errors": [
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada",
          "Regla: CAK55, Notificación: Correo electrónico no informado"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "23-02-2026 04:28:04 PM",
        "created_at": "23-02-2026 04:28:03 PM"
      },
      {
        "reference_code": "NOTA-2026-0008",
        "number": "NC201",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan company name",
          "trade_name": null,
          "company": "Alan company name",
          "names": null,
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "12700.00",
        "errors": [
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada",
          "Regla: CAK55, Notificación: Correo electrónico no informado"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "23-02-2026 04:07:00 PM",
        "created_at": "23-02-2026 04:06:59 PM"
      },
      {
        "reference_code": "NOTA-2026-0007",
        "number": "NC200",
        "correction_concept": {
          "code": "2",
          "name": "Anulación de factura electrónica"
        },
        "operation_type": {
          "code": "20",
          "name": "Nota Crédito que referencia una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan company name",
          "trade_name": null,
          "company": "Alan company name",
          "names": null,
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": {
            "code": "68679",
            "name": "San Gil",
            "department": {
              "code": "68",
              "name": "Santander"
            }
          }
        },
        "total": "11910.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado",
          "Regla: CBF02, Notificación: No se informo el numero de la factura referenciada",
          "Regla: CAS14, Notificación: No corresponde a un código valido de la lista.",
          "Regla: CAX14, Notificación: Reporta una tarifa diferente para uno de los tributos enunciados en la tabla 13.3.9"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "23-02-2026 03:50:09 PM",
        "created_at": "23-02-2026 03:50:08 PM"
      },
      {
        "reference_code": "NOTA-2026-0006",
        "number": "NC199",
        "correction_concept": {
          "code": "1",
          "name": "Devolución parcial de los bienes y/o no aceptación parcial del servicio"
        },
        "operation_type": {
          "code": "22",
          "name": "Nota Crédito sin referencia a una factura electrónica."
        },
        "api_client_name": "comoslab current",
        "customer": {
          "identification_document": {
            "code": "31",
            "name": "NIT"
          },
          "identification": "123456789",
          "dv": "6",
          "graphic_representation_name": "Alan company name",
          "trade_name": null,
          "company": "Alan company name",
          "names": null,
          "address": "No informado",
          "email": null,
          "phone": null,
          "legal_organization": {
            "code": "1",
            "name": "Persona Jurídica"
          },
          "municipality": null
        },
        "total": "11900.00",
        "errors": [
          "Regla: CAK55, Notificación: Correo electrónico no informado"
        ],
        "send_email": false,
        "is_validated": true,
        "validated_at": "23-02-2026 09:08:00 AM",
        "created_at": "23-02-2026 09:07:59 AM"
      }
    ],
    "pagination": {
      "total": 196,
      "per_page": 10,
      "current_page": 1,
      "last_page": 20,
      "from": 1,
      "to": 10,
      "links": [
        {
          "url": null,
          "label": "« Anterior",
          "active": false
        },
        {
          "url": "http://api.test/v2/credit-notes?page=1",
          "label": 1,
          "active": true,
          "page": 1
        },
        {
          "url": "http://api.test/v2/credit-notes?page=2",
          "label": 2,
          "active": false,
          "page": 2
        },
        {
          "url": "http://api.test/v2/credit-notes?page=3",
          "label": 3,
          "active": false,
          "page": 3
        },
        {
          "url": "http://api.test/v2/credit-notes?page=4",
          "label": 4,
          "active": false,
          "page": 4
        },
        {
          "url": null,
          "label": "...",
          "active": false
        },
        {
          "url": "http://api.test/v2/credit-notes?page=20",
          "label": 20,
          "active": false,
          "page": 20
        },
        {
          "url": "http://api.test/v2/credit-notes?page=2",
          "label": "Siguiente »",
          "active": false,
          "page": 2
        }
      ]
    }
  }
}

El endpoint devuelve información paginada de las notas crédito, incluyendo:

  • total: Total de las notas crédito.
  • por página: 10 resultados por página.
  • página actual: Página en la que se encuentra.
  • última página: Última página disponible.
  • desde: Índice inicial de los resultados.
  • hasta: Índice final de los resultados.
  • links: Navegación entre las páginas del endpoint.

Para navegar entre las páginas, utilice el parámetro de consulta page y especifique el número de página deseado.