Filtrar notas de ajuste

Esta sección explica cómo utilizar este endpoint para buscar y filtrar las notas de ajuste a documentos soporte, la respuesta de cada nota de ajuste es general si quiere información especifica de una nota de ajuste a documento soporte debe usar el endpoint: Ver nota de ajuste a documento soporte .

Método: GET

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

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

La respuesta del endpoint arroja el total de las notas de ajuste a documentos soporte generados, por pagina 10 resultados, pagina actual, ultima pagina, desde, hasta y los links de navegación entre el endpoint de notas de ajuste a documentos soporte, los anteriores campos con el fin de paginar la respuesta.

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

Si el número de página no existe, el objeto data estará vacío.

Encabezados de la Solicitud

Para realizar la solicitud es necesario incluir los siguientes encabezados:

Encabezado	Valor	Descripción
`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

filter[identification]: Filtrar por número de identificación.
filter[names]: Filtra por el nombre del proveedor.
filter[number]: Filtra por numero de nota de ajuste.
filter[prefix]: Filtra por prefijo de rango de numeración.
filter[reference_code]: Filtra por codigo de referencia.
filter[status]: Filtra por el estado del documento. 1 = validado, 0 si no esta validado.

Respuesta del Endpoint

Status 200

{
  "status": "OK",
  "message": "Solicitud exitosa",
  "data": {
    "data": [
      {
        "id": 75,
        "number": "NDA40",
        "api_client_name": "Halltec",
        "reference_code": "REF006",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "10-02-2025 10:22:38 AM"
      },
      {
        "id": 74,
        "number": "NDA39",
        "api_client_name": "Halltec",
        "reference_code": "REF005",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "10-02-2025 10:21:25 AM"
      },
      {
        "id": 73,
        "number": "NDA38",
        "api_client_name": "Halltec",
        "reference_code": "REF004",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "10-02-2025 10:20:17 AM"
      },
      {
        "id": 72,
        "number": "NDA37",
        "api_client_name": "Halltec",
        "reference_code": "REF003",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "10-02-2025 10:14:05 AM"
      },
      {
        "id": 71,
        "number": "NDA36",
        "api_client_name": "Halltec",
        "reference_code": "REF002",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "10-02-2025 10:13:32 AM"
      },
      {
        "id": 69,
        "number": "NDA35",
        "api_client_name": "Halltec",
        "reference_code": "REF001",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "40000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "07-02-2025 05:06:24 PM"
      },
      {
        "id": 68,
        "number": "NDA34",
        "api_client_name": "Halltec",
        "reference_code": "001",
        "identification": "1100970785",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "80000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "06-02-2025 09:45:54 PM"
      },
      {
        "id": 67,
        "number": "NDA33",
        "api_client_name": "Halltec",
        "reference_code": "002",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "80000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "06-02-2025 05:01:09 PM"
      },
      {
        "id": 66,
        "number": "NDA32",
        "api_client_name": "Halltec",
        "reference_code": "003",
        "identification": "123456789",
        "graphic_representation_name": "Alan Turing",
        "trade_name": null,
        "names": "Alan Turing",
        "email": "[email protected]",
        "total": "80000.00",
        "status": 1,
        "errors": [
          "Regla: NSAJ44b, Notificación: Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.",
          "Regla: NSAJ43b, Notificación: Nombre informado No corresponde al registrado en el RUT con respecto al Nit suminstrado."
        ],
        "created_at": "06-02-2025 04:29:32 PM"
      },
      {
        "id": 65,
        "number": "NDA31",
        "api_client_name": "Halltec",
        "reference_code": "004",
        "identification": "17879221513",
        "graphic_representation_name": "Stephanie M Rodriguez",
        "trade_name": null,
        "names": "Stephanie M Rodriguez",
        "email": "[email protected]",
        "total": "80000.00",
        "status": 1,
        "errors": [],
        "created_at": "06-02-2025 03:08:06 PM"
      }
    ],
    "pagination": {
      "total": 39,
      "per_page": 10,
      "current_page": 1,
      "last_page": 4,
      "from": 1,
      "to": 10,
      "links": [
        {
          "url": null,
          "label": "&laquo; Anterior",
          "page": null,
          "active": false
        },
        {
          "url": "http://api.test/v1/adjustment-notes?page=1",
          "label": 1,
          "page": 1,
          "active": true
        },
        {
          "url": "http://api.test/v1/adjustment-notes?page=2",
          "label": 2,
          "page": 2,
          "active": false
        },
        {
          "url": "http://api.test/v1/adjustment-notes?page=3",
          "label": 3,
          "page": 3,
          "active": false
        },
        {
          "url": "http://api.test/v1/adjustment-notes?page=4",
          "label": 4,
          "page": 4,
          "active": false
        },
        {
          "url": "http://api.test/v1/adjustment-notes?page=2",
          "label": "Siguiente &raquo;",
          "page": 2,
          "active": false
        }
      ]
    }
  }
}

El endpoint devuelve información paginada de los documentos soporte, incluyendo:

Total: Total de los documentos soporte.
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.
Si el número de página no existe, el objeto data estará vacío.