Movements

Descripción General

La API de periodos de facturación permite visibilizar los periodos de facturación de una tarjeta corporativa. Se permiten ver detalles sobre: periodo de facturación, traspaso de deuda y gastos asociados al periodo de facturación

Endpoints

Base URL

https://api.xpendit.com/public/v1/enterprises/{enterprise_id}/corporate-cards/{card_id}/billing_periods/{billing_period_id}/movements/

Reemplaza {enterprise_id} con el ID de tu empresa, {card_id} con el ID de la tarjeta corporativa y billing_period_id el ID del periodo de facturación

1. Obtener movimientos del periodo de facturación

Obtiene la información detallada de un usuario específico.

Endpoint

GET /public/v1/enterprises/{enterprise_id}/corporate-cards/{card_id}/billing-periods/{billing_period_id}/movements/

Query Parameters

Parámetro	Tipo	Descripción
`expand`	string	Campos adicionales a incluir. Valores:`renconciliation`
`type`	string	Filtro. Valores: `payment,expense,associated_fee,other_fee`
`reconciled`	boolean	Filtro. Valores: `true,false`
`page`	integer	Número de página (inicia en 1)
`page_size`	integer	Cantidad de resultados por página (máx: 100)

Ejemplo

GET /public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/550e8400-e29b-41d4-a716-446655440000/
Authorization: Api-Key en_sk_xxxxx

Response 200 OK:

{
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
        {
            "id": "731ef13b-940d-4d1a-b012-7bc577f6e8aa",
            "amount": {
                "amount": 6570.0,
                "currency": "CLP"
            },
            "description": "Apoquindo 7             compras",
            "transaction_date": "2025-11-20",
            "is_deposit": false,
            "reconciliation": {
                "id": "5a7bf60e-a513-4f2c-ae76-1f22a1240bb9",
                "expense": {
                    "id": "74697143-6a5a-4aa3-966a-8eef9a0d1914",
                    "description": "gasto tarjeta",
                    "expense_number": 1587,
                    "date": "2025-11-20T00:00:00Z",
                    "amount": {
                        "amount": 6570.0,
                        "currency": "CLP"
                    },
                    "usd_amount": {
                        "amount": 7.06275,
                        "currency": "USD"
                    },
                    "cost_center": {
                        "id": "b788c12f-41f7-47b3-b3af-53c7a2c70bbc",
                        "name": "Comercial"
                    },
                    "state": "pending"
                }
            },
            "type": "expense",
            "current_installment": 1,
            "total_installments": 1,
            "reference_code": "211136398338335",
            "foreign_amount": null,
            "is_debt_transfer": false
        }
    ],
    "status": 200,
    "error": ""
}

2. Obtener in movimiento del periodo de facturación

Obtiene un movimiento específico de un periodo de facturación

Endpoint

GET /public/v1/enterprises/{enterprise_id}/corporate-cards/{card_id}/billing-periods/

Query Parameters

Parámetro	Tipo	Descripción
`expand`	string	Campos adicionales a incluir. Valores:`renconciliation`

Ejemplo: Todos los periodos de facturación

GET /public/v1/enterprises/660e8400-e29b-41d4-a716-446655440000/corporate-cards/
Authorization: Api-Key en_sk_xxxxx

Response 200 OK:

{
    "id": "731ef13b-940d-4d1a-b012-7bc577f6e8aa",
    "amount": {
        "amount": 6570.0,
        "currency": "CLP"
    },
    "description": "Apoquindo 7             compras",
    "transaction_date": "2025-11-20",
    "is_deposit": false,
    "reconciliation": {
        "id": "5a7bf60e-a513-4f2c-ae76-1f22a1240bb9",
        "expense": {
            "id": "74697143-6a5a-4aa3-966a-8eef9a0d1914",
            "description": "gasto tarjeta",
            "expense_number": 1587,
            "date": "2025-11-20T00:00:00Z",
            "amount": {
                "amount": 6570.0,
                "currency": "CLP"
            },
            "usd_amount": {
                "amount": 7.06275,
                "currency": "USD"
            },
            "cost_center": {
                "id": "b788c12f-41f7-47b3-b3af-53c7a2c70bbc",
                "name": "Comercial"
            },
            "state": "pending"
        }
    },
    "type": "expense",
    "current_installment": 1,
    "total_installments": 1,
    "reference_code": "211136398338335",
    "foreign_amount": null,
    "is_debt_transfer": false,
    "status": 200,
    "error": ""
}