Billings Management

About Verifacti Integration

Our integration with Verifacti supports Passthrough.

👍
PASSTHROUGH SUPPORT
Any additional field required by AEAT regulations that is not in the Ecart Pay base schema can be sent within billing_information or within each object inside the items array, and will be sent as is to the billing provider.

⚠️
IMPORTANT
To follow the steps below, it is essential to have the corresponding Authorization Token. For more information, please refer to the following documentation page: Authorization Token

Create Order Invoice (Verifactu)

Create and register an electronic invoice via Verifacti to complain with AEAT fiscal regulations for Verifactu. The billing record will be generated and submitted to the AEAT.

The status of the submission can be queried with the Submission Status endpoint.

💻
Visit our API Reference to test this endpoint.

Endpoint

POST https://sandbox.ecartpay.com/api/billings
POST https://pay.ecart.com/api/billings

Headers

Authorization: token

Query Parameters

country: Two digit ISO code for country ("ES" for Spain).
- This query param acts as the inital prefix of the sequence base for the invoice number, unless a locales is included in the request body.

Request Body

Key values:

order_id: Links the invoice to an existing order, automatically retrieving items and customer details to ensure data consistency.
billing_config: An object containing specific configuration options for the invoice:
- locales: Two-digit code to determine the language in which the PDF invoice will be generated according to the relevant location. Currently supports ES for Spain, IT for Italy and FR for France. This two-digit code becomes the initial prefix in the sequence base of the invoice numeration.
  - Defaults to ES if not included in the request.
- indicator: Serves as a functional document identifier used to categorize different types of invoices or transactions within the serialization logic.
  - Purpose: It acts as a prefix (following the country code, which is obtained from the country query param or the locales field in the request body, if included) to separate invoice sequences by department or transaction type (e.g., "COM" for Commercial, "REC" for Receipts).
  Example: A request to create an order invoice with country=ES as query param with an "indicator": "COM" in the request body results in a sequence base of ESCOM-# (X stands for the corresponding numeration counter).
- serie_date: The serie_date is a temporal serialization toggle that determines whether the invoice number should be time-stamped at the month/year level. Can be true or false.
  - Purpose: When set to true, it triggers the inclusion of a date-based suffix in the invoice number to facilitate monthly accounting and prevent sequence collisions across different periods.
  - Behavior: It appends a 4-digit suffix in YYMM format (e.g., "2512" for December 2025) to the invoice prefix.
  Example: A request made in December 2025 to create an order invoice with country=ES as query param, with an "indicator": "COM", and "serie_date": true in the request body results in a sequence base of ESCOM2512-# (# stands for the corresponding numeration counter).
- vies: Activates the intra-community tax exemption (0% VAT) and adds the mandatory legal disclaimer to the PDF.

Examples

Request

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI........' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "EUR",
    "items": [
        {
            "name": "Consultoría Táctica",
            "quantity": 1,
            "price": 100.00,
            "discount": 0
        }
    ],
    "billing_information": {
        "serie": "",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España"
    },
    "billing_config": {
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": false
    }
}'

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "EUR",
    "items": [
        {
            "name": "Consultoría Táctica",
            "quantity": 1,
            "price": 100.00,
            "discount": 0
        }
    ],
    "billing_information": {
        "serie": "",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España"
    },
    "billing_config": {
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": true
    }
}'

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI............' \
--header 'Content-Type: application/json' \
--data '{
    "order_id": "6945af3eace40e5592eb22c6",
    "billing_information": {
        "serie": "",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España"
    },
    "billing_config": {
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": false
    }
}'

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI..........' \
--header 'Content-Type: application/json' \
--data '{
    "order_id": "6945aff0ace40e5592eb22f0",
    "billing_information": {
        "serie": "",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España"
    },
    "billing_config": {
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": true
    }
}'

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI..........' \
--header 'Content-Type: application/json' \
--data '{
    "currency": "EUR",
    "items": [
        {
            "name": "Servicio Rectificado",
            "price": 1000,
            "quantity": 2,
            "discount": 0,
            "tax": 420,
            "total": 2420,
            "is_service": false
        }
    ],
    "billing_information": {
        "serie": "",
        "first_name": "Sergio",
        "last_name": "Ramos",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "address1": "Calle Mayor 1",
        "address2": "Madrid 28080",
        "country": "España",
        "tipo_factura": "R1",
        "tipo_rectificativa": "S",
        "fecha_expedicion": "03-12-2025",
        "fecha_operacion": "01-12-2025",
        "descripcion": "Rectificacion por sustitucion",
        "importe_rectificativa": {
            "base_rectificada": "2000",
            "cuota_rectificada": "240"
        },
        "billing_config": {
            "locales": "ES",
            "indicator": "REC",
            "serie_date": true,
            "vies": false
        },
        "facturas_rectificadas": [
            {
                "serie": "ESCOM2512-",
                "numero": "30",
                "fecha_expedicion": "10-12-2025"
            }
        ]
    }
}'

curl --location 'http://sandbox.ecartpay.com/api/billings?country=ES' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI.........' \
--header 'Content-Type: application/json' \
--data '{
    "order_id": "6945b302ace40e5592eb2356", 
    "currency": "EUR",
    "items": [
        {
            "name": "Instalación de Licencia Software (IVA 21% + RE 5.2%)",
            "price": 305,
            "quantity": 1,
            "discount": 0,
            "surcharge_rate": 5.2,   
            "taxes": [
                {
                    "rate": 21
                }
            ]
        }
    ],
    "billing_information": {
        "locales": "ES",
        "serie": "",
        "first_name": "Juan",
        "last_name": "Perez",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "address1": "Paseo de la Castellana 100",
        "postal_code": "28080",
        "city": "Madrid",
        "country": "ES",
        "clave_regimen": "18"
    },
    "billing_config": {
        "locales": "ES",
        "indicator": "RDE",
        "serie_date": true,
        "vies": false
    }
}'

Response

{
    "order_id": "6945b065ace40e5592eb2315",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "897a81af-3045-4e27-80bc-6221cabf7722",
    "provider_invoice_uuid": "897a81af-3045-4e27-80bc-6221cabf7722",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ESVIES2512-5&fecha=19-12-2025&importe=121.00",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAw+SURBVO3BUW5ry7IkwfCC5j9lb30n9IC6i5SS+3SY4bdUVS06qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLvrIIyCdRcwPIU2puAJnUvALIpOadgExqngIyqbkF5Ck1TwGZ1ExAPomaDSdVVctOqqqWnVRVLT.........",
    "fingerprint": "9B4C28EA1B614D1A4DCF9CD745BC7BAD1A723E8F19E55B6C6FD5E33121B492C4",
    "status_provider": "Pendiente",
    "number": "ESCOM2512-5",
    "status": "created",
    "name": "Juan Perez",
    "notes": [],
    "relations": [],
    "invoice": {
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España",
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": false
    },
    "items": [
        {
            "name": "Consultoría Táctica",
            "quantity": 1,
            "price": 100,
            "discount": 0,
            "total": 100,
            "tax": 0,
            "is_service": false,
            "taxes": []
        }
    ],
    "totals": {
        "subtotal": 100,
        "tax": 21,
        "surcharge": 0,
        "total": 121
    },
    "billing_at": "2025-12-19T20:07:01.741Z",
    "id": "6945b067ace40e5592eb231d",
    "created_at": "2025-12-19T20:07:03.034Z",
    "updated_at": "2025-12-19T20:07:03.034Z",
    "link": "http://sandbox.ecartpay.com/billing?order_id=6945b065ace40e5592eb2315"
}

{
    "order_id": "6945b0a4ace40e5592eb2326",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "66b81e6d-5c95-4698-8960-42f6a7b861eb",
    "provider_invoice_uuid": "66b81e6d-5c95-4698-8960-42f6a7b861eb",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ESVIES2512-6&fecha=19-12-2025&importe=100.00",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAxDSURBVO3BUW5ry7IkwfCC5j9lb30n9IC6i5SS+3SY4bdUVS06qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLvrIIyCdRcwPIU2omIJOadwMyqXknIJOap4BMam4BeUrNU0AmNROQT6Jmw0lV1bKTqqplJ1VVy06.......",
    "status_provider": "Pendiente",
    "number": "ESCOM2512-6",
    "status": "created",
    "name": "Juan Perez",
    "notes": [],
    "relations": [],
    "invoice": {
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España",
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": true
    },
    "items": [
        {
            "name": "Consultoría Táctica",
            "quantity": 1,
            "price": 100,
            "discount": 0,
            "total": 100,
            "tax": 0,
            "is_service": false,
            "taxes": []
        }
    ],
    "totals": {
        "subtotal": 100,
        "tax": 0,
        "surcharge": 0,
        "total": 100
    },
    "billing_at": "2025-12-19T20:08:04.793Z",
    "id": "6945b0a5ace40e5592eb232e",
    "created_at": "2025-12-19T20:08:05.801Z",
    "updated_at": "2025-12-19T20:08:05.801Z",
    "link": "http://sandbox.ecartpay.com/billing?order_id=6945b0a4ace40e5592eb2326"
}

{
    "order_id": "6945af3eace40e5592eb22c6",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "28394414-0da7-4ac8-aec2-5d01ff044a71",
    "provider_invoice_uuid": "28394414-0da7-4ac8-aec2-5d01ff044a71",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ESCOM2512-33&fecha=19-12-2025&importe=369.05",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAyVSURBVO3BUY5by5IEwfAC979ln/udaDwUDtlKShNm+J9UVS06qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLXlkE5Juo+SQgk5obQCY1E5CfqJmATGomIJ+kZgJyQ80E5CdqJiA31ExAJjU3gExqJiDfRM2Gk6q..........",
    "fingerprint": "27ADFD590CCF8CCB4FAE4A836E862579866F09B849FAB44BC820A29885A6DF18",
    "status_provider": "Pendiente",
    "number": "ESCOM2512-33",
    "status": "created",
    "name": "Juan Perez",
    "notes": [],
    "relations": [],
    "invoice": {
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España",
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": false
    },
    "items": [
        {
            "name": "Instalación de Licencia Software (Estándar)",
            "quantity": 2,
            "price": 100,
            "discount": 0,
            "total": 200,
            "tax": 0,
            "is_service": true,
            "taxes": []
        },
        {
            "name": "Instalación de Licencia Software (Pro)",
            "quantity": 1,
            "price": 105,
            "discount": 0,
            "total": 105,
            "tax": 0,
            "is_service": true,
            "taxes": []
        }
    ],
    "totals": {
        "subtotal": 305,
        "tax": 64.05,
        "surcharge": 0,
        "total": 369.05
    },
    "billing_at": "2025-12-19T20:02:14.134Z",
    "id": "6945af47ace40e5592eb22da",
    "created_at": "2025-12-19T20:02:15.375Z",
    "updated_at": "2025-12-19T20:02:15.375Z",
    "link": "http://sandbox.ecartpay.com/billing?order_id=6945af3eace40e5592eb22c6"
}

{
    "order_id": "6945aff0ace40e5592eb22f0",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "e47606ea-a0ac-41b9-974b-e705fc796cda",
    "provider_invoice_uuid": "e47606ea-a0ac-41b9-974b-e705fc796cda",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ESCOM2512-34&fecha=19-12-2025&importe=305.00",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAxZSURBVO3BUW5rS3AEwcqB9r/ltL4bNDA+otS8zxWB31JVteikqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS37yiIgn0TNDSBPqZmA3FAzAXlFzQRkUvNOQCY1E5BJzQRkUnMLyFNqngIyqZmAfBI1G06qqpadVFUt........",
    "fingerprint": "FE0E2DF7BB34AC445096C876D4AE9EDED799FB3435802C6D7FDBAC4138BDEED0",
    "status_provider": "Pendiente",
    "number": "ESCOM2512-34",
    "status": "created",
    "name": "Juan Perez",
    "notes": [],
    "relations": [],
    "invoice": {
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "first_name": "Juan",
        "last_name": "Perez",
        "address1": "Paseo de la Castellana 100",
        "address2": "Madrid 28080",
        "country": "España",
        "locales": "ES",
        "indicator": "COM",
        "serie_date": true,
        "vies": true
    },
    "items": [
        {
            "name": "Instalación de Licencia Software (Estándar)",
            "quantity": 2,
            "price": 100,
            "discount": 0,
            "total": 200,
            "tax": 0,
            "is_service": true,
            "taxes": []
        },
        {
            "name": "Instalación de Licencia Software (Pro)",
            "quantity": 1,
            "price": 105,
            "discount": 0,
            "total": 105,
            "tax": 0,
            "is_service": true,
            "taxes": []
        }
    ],
    "totals": {
        "subtotal": 305,
        "tax": 0,
        "surcharge": 0,
        "total": 305
    },
    "billing_at": "2025-12-19T20:05:23.911Z",
    "id": "6945b005ace40e5592eb2304",
    "created_at": "2025-12-19T20:05:25.112Z",
    "updated_at": "2025-12-19T20:05:25.112Z",
    "link": "http://sandbox.ecartpay.com/billing?order_id=6945aff0ace40e5592eb22f0"
}

{
    "order_id": "6945b25dace40e5592eb2339",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "c90236b3-e8b1-4b41-ba95-3a8807554958",
    "provider_invoice_uuid": "c90236b3-e8b1-4b41-ba95-3a8807554958",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ES-11&fecha=03-12-2025&importe=2420.00",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAwhSURBVO3BUXJbQZIEwYw23v/Ksfwuw4z1PkIsSJPu+C1VVYtOqqqWnVRVLTupqlp2UlW17KSqatlJVdWyk6qqZSdVVctOqqqWnVRVLTupqlp2UlW17KSqatlJVdWyk6qqZSdVVctOqqqWnVRVLTupqlp2UlW17KSqatlJVdWyk6qqZSdVVctOqqqWnVRVLTupqlp2UlW17KSqatlJVdWyrywC8knUTEAmNZ8OyKRmAnJDzQRkUvMUkBtqXgFyQ80NIJOaG0AmNROQT6Jmw0lV1bKTqqplJ1V..........",
    "fingerprint": "EE76A7EBF80CD05E77476C753CFDA61A42FCCEE2CE7319C06F1911E99029D3A0",
    "status_provider": "Pendiente",
    "number": "ES-11",
    "status": "created",
    "name": "Sergio Ramos",
    "notes": [],
    "relations": [],
    "invoice": {
        "first_name": "Sergio",
        "last_name": "Ramos",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "address1": "Calle Mayor 1",
        "address2": "Madrid 28080",
        "country": "España",
        "tipo_factura": "R1",
        "tipo_rectificativa": "S",
        "fecha_expedicion": "03-12-2025",
        "fecha_operacion": "01-12-2025",
        "descripcion": "Rectificacion por sustitucion",
        "importe_rectificativa": {
            "base_rectificada": "2000",
            "cuota_rectificada": "240"
        },
        "billing_config": {
            "locales": "ES",
            "indicator": "REC",
            "serie_date": true,
            "vies": false
        },
        "facturas_rectificadas": [
            {
                "serie": "ESCOM2512-",
                "numero": "30",
                "fecha_expedicion": "10-12-2025"
            }
        ]
    },
    "items": [
        {
            "name": "Servicio Rectificado",
            "quantity": 2,
            "price": 1000,
            "discount": 0,
            "total": 2000,
            "tax": 420,
            "is_service": false,
            "taxes": []
        }
    ],
    "totals": {
        "subtotal": 2000,
        "tax": 420,
        "surcharge": 0,
        "total": 2420
    },
    "billing_at": "2025-12-19T20:15:25.443Z",
    "id": "6945b25eace40e5592eb2341",
    "created_at": "2025-12-19T20:15:26.342Z",
    "updated_at": "2025-12-19T20:15:26.342Z",
    "link": "http://localhost:9000/billing?order_id=6945b25dace40e5592eb2339"
}

{
    "order_id": "6945b302ace40e5592eb2356",
    "account_id": "68a4c3150b28a9584305a2a6",
    "provider_id": "6917807fca828055fb9888e9",
    "provider_invoice_id": "4843af47-0ae0-4559-9f3d-a4be83e34c9e",
    "provider_invoice_uuid": "4843af47-0ae0-4559-9f3d-a4be83e34c9e",
    "verification_url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ESRDE2512-4&fecha=19-12-2025&importe=384.91",
    "qr_image": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAxiSURBVO3BUW4kS3AEwfAC739l134nKKDU7GXOPoUZ/pGqqkUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZVxYB+SRqbgB5Ss0EZFIzAZnU3AIyqXkTkEnNBGRSMwGZ1NwC8iY1N4BMaiYgn0TNhpOqqmUnVVXLTqqqlp1UVS37yodR8xuAbADyG4BMap4CMqm5AeQGkJ8AMqmZgExqJiA3gExqnlLzG4B8ipOqqmUnVVXLTqqqlp1UVS37yj8AyFNqfgL.........",
    "fingerprint": "9BACEA08F9180EDB567E2294AB2F3BF0E7B2A012FFB02DC2D8FFC8B52B107756",
    "status_provider": "Pendiente",
    "number": "ESRDE2512-4",
    "status": "created",
    "name": "Juan Perez",
    "notes": [],
    "relations": [],
    "invoice": {
        "locales": "ES",
        "first_name": "Juan",
        "last_name": "Perez",
        "razons": "Empresa Cliente SA",
        "nif": "A15022510",
        "address1": "Paseo de la Castellana 100",
        "postal_code": "28080",
        "city": "Madrid",
        "country": "ES",
        "clave_regimen": "18",
        "indicator": "RDE",
        "serie_date": true,
        "vies": false
    },
    "items": [
        {
            "name": "Instalación de Licencia Software (IVA 21% + RE 5.2%)",
            "price": 305,
            "quantity": 1,
            "discount": 0,
            "surcharge_rate": 5.2,
            "taxes": [
                {
                    "rate": 21
                }
            ],
            "is_service": false
        }
    ],
    "totals": {
        "subtotal": 305,
        "tax": 64.05,
        "surcharge": 15.86,
        "total": 384.91
    },
    "billing_at": "2025-12-19T20:18:27.599Z",
    "id": "6945b314ace40e5592eb236f",
    "created_at": "2025-12-19T20:18:28.544Z",
    "updated_at": "2025-12-19T20:18:28.544Z",
    "link": "http://sandbox.ecartpay.com/billing?order_id=6945b302ace40e5592eb2356"
}

Cancel invoice

This endpoint allows you to cancel existing invoices. By doing so, new information is sent to the AEAT.

💻
Visit our API Reference to test this endpoint.

Endpoint

PUT https://ecartpay.com/api/billings/{billing_id}/cancel
PUT https://sandbox.ecartpay.com/api/billings/{billing_id}/cancel

Headers

Authorization: token

Path Parameters

id: The id of the invoice to cancel.

Request Body

{
    "reason": "Cancellation test"
}

Examples

Request

curl --location --request PUT 'https://sandbox.ecartpay.com/api/billings/691df6e35ed9d02e3f07c7df/cancel' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "Cancellation test"
}'

Response

{
    "id": "691df6e35ed9d02e3f07c7df",
    "number": "OR0000040265",
    "name": "Juan Pérez",
    "status": "cancelled",
    "provider": "Verifacti",
    "concept": "Consultoría IT",
    "currency": "EUR",
    "amount": 121,
    "created_at": "2025-11-19T16:57:06.439Z"
}

Invoice Status

This endpoint allows you to consult the status of an invoice in the AEAT system.

💻
Visit our API Reference to test this endpoint.

Endpoint

GET https://ecartpay.com/api/billings/{billing_id}/status-aeat
GET https://sandbox.ecartpay.com/api/billings/{billing_id}/status-aeat

Headers

Authorization: token

Path Parameters

billing_id: The id of the invoice that will be consulted with the AEAT.

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/billings/691e47548a9d2994b780a9fd/status-aeat' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Cookie: __cf_bm=jaMmdzGAd8EWGBZ8Yng9RKLvMYOqBjshWsB12qAL51Y-1764191560-1.0.1.1-.1mQTY4MBm98F8k1e.ROevaHR_60Wm3hsls8sPVIYqQseljqErWFpgO2w7fJC3ldwD3I2HnsRrYKCQZEjJ1mNggPAPkpIAYKWDCPO4cwhxw; lang=en'

Response

{
    "uuid": "3e4566f7-8ae4-4dab-8cb5-a83edc7eee9b",
    "nif_emisor": "B75777847",
    "num_serie": "cb41_AOR0000040288",
    "fecha_expedicion": "19-11-2025",
    "subsanacion": "N",
    "rechazo_previo": "N",
    "tipo_factura": "F1",
    "descripcion": "Factura orden OR0000040288",
    "nif_destinatario": "B75777847",
    "nombre_destinatario": "Empresa de Prueba S.L.",
    "lineas": [
        {
            "base_imponible": "100",
            "tipo_impositivo": "21",
            "cuota_repercutida": "21",
            "calificacion_operacion": "S1",
            "clave_regimen": "01"
        }
    ],
    "importe_total": "121",
    "cuota_total": "21",
    "encadenamiento": {
        "nif_emisor": "B75777847",
        "num_serie": "cb41_AOR0000040287",
        "fecha_expedicion": "19-11-2025",
        "huella": "8565A18CE803BEED67D992A52E2D1928510D74FA10BAE495B892EF9EF4EA4355"
    },
    "huella": "326B92F4ED93E88BFE4A710A45F3DD138164D70751C64A35CCDE86262A900BD2",
    "ultima_modificacion": "2025-11-19T23:41:02+01:00",
    "estado": "Correcta"
}

Submission Status

Technical query to the AEAT about the invoice submission status using the uuid.

💻
Visit our API Reference to test this endpoint.

Endpoint

GET https://ecartpay.com/api/billings/{id}/status-record/{uuid}
GET https://sandbox.ecartpay.com/api/billings/{id}/status-record/{uuid}

Headers

Authorization: token

Path Parameters

billing_id: The id of the invoice that will be consulted with the AEAT.

uuid: The uuid of the invoice that will be consulted with the AEAT.

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/billings/69271719afa1c453f7511cc9/status-record/a8d77be0-a702-40d2-a6b9-16cd54e39fa8' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI.......' \
--header 'Cookie: __cf_bm=jaMmdzGAd8EWGBZ8Yng9RKLvMYOqBjshWsB12qAL51Y-1764191560-1.0.1.1-.1mQTY4MBm98F8k1e.ROevaHR_60Wm3hsls8sPVIYqQseljqErWFpgO2w7fJC3ldwD3I2HnsRrYKCQZEjJ1mNggPAPkpIAYKWDCPO4cwhxw; lang=en'

Response

{
    "nif": "B75777847",
    "serie": "cb41_ITCOM",
    "numero": "OR0000041031",
    "fecha_expedicion": "26-11-2025",
    "operacion": "Alta",
    "estado": "Correcto",
    "url": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B75777847&numserie=cb41_ITCOMOR0000041031&fecha=26-11-2025&importe=3105.00",
    "qr": "iVBORw0KGgoAAAANSUhEUgAAASIAAAEiCAYAAABdvt+2AAAAAklEQVR4AewaftIAAAxxSURBVO3BUY5jSXAEwfBC3//KrvlOUEDpkdPJWYUZ/pGqqkUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZSVXVspOqqmUnVVXLTqqqlp1UVS07qapadlJVteykqmrZTxYB+SZqbgB5Ss0E5NPUTEAmNZ8EZFJzA8ik5h1APknNDSCTmgnIN1Gz4aSqatlJVdWyk6qqZSdVVct+8mXU/AYgT6mZgNwAckPNO4B8EpBJzQ0gTwF5h5oJyKTmKSCTmqfU/AYg3+KkqmrZSVXVspOqqmUnVVXLfvIPAPKUmncA+dvUTEBuqHlFzQ0gk5pJzVNqngLyaWomIDfUbAHylJpvdlJVteykqmrZSVXVspOqqmU/qf8zNROQSc3fBuQdaiYgk5q/DcgNNZ+mZgLyFJBJTb12UlW17KSqatlJVdWyk6qqZT+pj1BzA8ikZlIzAbml5pOAPAXkhpp3AHlKzaRmAlKfd1JVteykqmrZSVXVspOqqmU/+Qeo+XZAPgnIDTW/Qc1TQG4AmdRMQF5RMwF5CsikZoua/6qTqqplJ1VVy06qqpadVFUtO6mqWvaTLwPkv0LNBOQpNROQV9RMQCY1TwGZ1NxQMwH5DWomIJO......",
    "codigo_error": null,
    "mensaje_error": null,
    "estado_registro_duplicado": null
}

List Invoices

Consultation of invoices presented to the AEAT with filters.

💻
Visit our API Reference to test this endpoint.

Endpoint

POST https://ecartpay.com/api/billings/providers/{id}/list-aeat
POST https://sandbox.ecartpay.com/api/billings/providers/{id}/list-aeat

Headers

Authorization: token

Path Parameters

id: The id of the billing provider. (6917807fca828055fb9888e9 for Verifacti)
- You can find the id of Verifacti by using the Get Billing Providers endpoint.

Request Body

ejercicio(required): Exercise of the date of operation or, failing that, of the date of issue.
periodo (required): Period of the date of operation or, failing that, the date of issue.
serie: Invoice series. Mandatory if numero is included.
numero: Invoice number. Mandatory if serie is included.
rango_fecha_expedicion: Range of issue dates of the invoices that you wish to consult.
- desde: Start date of the range of issue dates of the invoices you wish to consult.
- hasta: End date of the range of issue dates of the invoices you wish to consult. It must necessarily be greater than since.

{
  "ejercicio": "2024",
  "periodo": "12",
  "serie": "ESCOM",
	"numero": "012345",
  "rango_fecha_expedicion": {
    "desde": "01-12-2024",
    "hasta": "04-12-2024"
  }
}

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/billings/providers/6917807fca828055fb9888e9/list-aeat' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=jaMmdzGAd8EWGBZ8Yng9RKLvMYOqBjshWsB12qAL51Y-1764191560-1.0.1.1-.1mQTY4MBm98F8k1e.ROevaHR_60Wm3hsls8sPVIYqQseljqErWFpgO2w7fJC3ldwD3I2HnsRrYKCQZEjJ1mNggPAPkpIAYKWDCPO4cwhxw; lang=en' \
--data '{
    "ejercicio": "2025",
    "periodo": "11"
}'

Response

{
    "paginacion": "N",
    "data": [
        {
            "uuid": "a8d77be0-a702-40d2-a6b9-16cd54e39fa8",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ITCOMOR0000041031",
            "fecha_expedicion": "26-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000041031",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Gianni Perazzo",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3105",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ITCOMOR0000041022",
                "fecha_expedicion": "25-11-2025",
                "huella": "E39F8AD4399F1FFAA1F6674EDAE0267D37EDA13309AD9559A21530192EC205CB"
            },
            "huella": "33344D8F0B1B96F3AB7AA389D04BC16BF50BDFF71D8F8A089E8F0DF2715DA862",
            "ultima_modificacion": "2025-11-26T16:05:07+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "49d986dd-24da-4cd5-8458-4ac0563e28bb",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ITCOMOR0000041022",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000041022",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Gianni Perazzo",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3105",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ITCOMOR0000041012",
                "fecha_expedicion": "25-11-2025",
                "huella": "24183684D6BE3078255DFF6A2ED1AB484BC3AA523DF0701818BAC9EAF491FFCB"
            },
            "huella": "E39F8AD4399F1FFAA1F6674EDAE0267D37EDA13309AD9559A21530192EC205CB",
            "ultima_modificacion": "2025-11-26T00:52:05+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "0516ec8a-9e5b-4476-90e8-b145d89c7636",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ITCOMOR0000041012",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000041012",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Gianni Perazzo",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "232.05",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3757.05",
            "cuota_total": "652.05",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000041001",
                "fecha_expedicion": "25-11-2025",
                "huella": "EF24045CAD2AF62C882C305D8EE481A30B1E473C260BA090A6A0C283B8C423AE"
            },
            "huella": "24183684D6BE3078255DFF6A2ED1AB484BC3AA523DF0701818BAC9EAF491FFCB",
            "ultima_modificacion": "2025-11-26T00:39:06+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "56d11cf6-e3cd-4e39-af75-265e128fc513",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000041001",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000041001",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "232.05",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3757.05",
            "cuota_total": "652.05",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040987",
                "fecha_expedicion": "25-11-2025",
                "huella": "84B588247E1C3AE37F26A0DFBD2ADA8C1FA27F00C99038D68A6FD43B023A1E90"
            },
            "huella": "EF24045CAD2AF62C882C305D8EE481A30B1E473C260BA090A6A0C283B8C423AE",
            "ultima_modificacion": "2025-11-26T00:07:02+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "359be64c-b4ba-43e3-8c70-7d24352421ba",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040987",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040987",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "232.05",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3757.05",
            "cuota_total": "652.05",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040986",
                "fecha_expedicion": "25-11-2025",
                "huella": "C4249184946AB4B66611FF70A498767C168ECA685B6C799A4F499DD4A370A34C"
            },
            "huella": "84B588247E1C3AE37F26A0DFBD2ADA8C1FA27F00C99038D68A6FD43B023A1E90",
            "ultima_modificacion": "2025-11-25T22:46:01+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "ba8f4ab0-cbf8-4b30-ba32-8ae4070b7dfa",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040986",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040986",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3105",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040981",
                "fecha_expedicion": "25-11-2025",
                "huella": "2A23038E8DA3974875026211AE1F214A1330C84F53448DE0562D8EB55A2BFA9C"
            },
            "huella": "C4249184946AB4B66611FF70A498767C168ECA685B6C799A4F499DD4A370A34C",
            "ultima_modificacion": "2025-11-25T22:44:05+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "9dfe4cee-8f75-409a-9f62-d4e8cb97439a",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040981",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040981",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                },
                {
                    "base_imponible": "1105",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "3105",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040962",
                "fecha_expedicion": "25-11-2025",
                "huella": "090146025E98AC711A2DFAB927ACE63D94C76C0C131FEB0C99B49E1F44B7F740"
            },
            "huella": "2A23038E8DA3974875026211AE1F214A1330C84F53448DE0562D8EB55A2BFA9C",
            "ultima_modificacion": "2025-11-25T22:15:02+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "e2f45b62-56fa-4f68-832d-c9353b9fcd10",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040962",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040962",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2000",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040961",
                "fecha_expedicion": "25-11-2025",
                "huella": "89EA11F063850F4F7F7697FACD660DD930A796992BDA93D35C06420E35E35AF8"
            },
            "huella": "090146025E98AC711A2DFAB927ACE63D94C76C0C131FEB0C99B49E1F44B7F740",
            "ultima_modificacion": "2025-11-25T19:53:04+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "49460214-44e1-4467-9ce6-15084f95c93c",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040961",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040961",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2420",
            "cuota_total": "420",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040960",
                "fecha_expedicion": "25-11-2025",
                "huella": "16C1A27F616EFF9C75CF43F1DE2B95D563E47B56A144F7AEC981AD1180AAABE1"
            },
            "huella": "89EA11F063850F4F7F7697FACD660DD930A796992BDA93D35C06420E35E35AF8",
            "ultima_modificacion": "2025-11-25T19:51:02+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "f4e35265-20fc-470c-8664-b0d1c3fa97ba",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_AOR0000040960",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040960",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2420",
            "cuota_total": "420",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOM0235000",
                "fecha_expedicion": "24-11-2025",
                "huella": "66353BD73AD1E83DD945DCD03A501298CF40B3A0BE025DC97439722197B78608"
            },
            "huella": "16C1A27F616EFF9C75CF43F1DE2B95D563E47B56A144F7AEC981AD1180AAABE1",
            "ultima_modificacion": "2025-11-25T19:45:03+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "f2adde64-7142-441b-816d-ddae0751f58c",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOM0235000",
            "fecha_expedicion": "24-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Descripcion de la operacion",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Hugo Morin",
            "lineas": [
                {
                    "base_imponible": "1000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "210",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "1210",
            "cuota_total": "210",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOM0234999",
                "fecha_expedicion": "24-11-2025",
                "huella": "B30F826753197C48087271905E021515C971C4B91D08FDDCBAFA59B7FA744ACE"
            },
            "huella": "66353BD73AD1E83DD945DCD03A501298CF40B3A0BE025DC97439722197B78608",
            "ultima_modificacion": "2025-11-25T19:42:06+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "6281d916-f2cb-4867-b317-dcbbd326f832",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOM0234999",
            "fecha_expedicion": "24-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Descripcion de la operacion",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Hugo Morin",
            "lineas": [
                {
                    "base_imponible": "1000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "210",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "1210",
            "cuota_total": "210",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_ESCOMOR0000040959",
                "fecha_expedicion": "25-11-2025",
                "huella": "D331ACA18BA042AF3395E500A22BEF71C7667A964E1777BD948B5B5CF7FC9E29"
            },
            "huella": "AFAFA253DABC7B85338C2E3D7E8DB34EC681445C9DAAFCC481771EE69E9CD802",
            "ultima_modificacion": "2025-11-25T19:39:03+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "93d98978-5742-415d-b845-7e1b63d3194d",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_ESCOMOR0000040959",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040959",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2420",
            "cuota_total": "420",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040946",
                "fecha_expedicion": "25-11-2025",
                "huella": "F00BAE9BDCA0D1F11EF4003782E7CE890B6A2338507FED6E09CB51E1314AE12C"
            },
            "huella": "D331ACA18BA042AF3395E500A22BEF71C7667A964E1777BD948B5B5CF7FC9E29",
            "ultima_modificacion": "2025-11-25T19:36:06+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "427facd1-1b9f-4a51-b736-7008dfb65b4c",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_AOR0000040946",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040946",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2420",
            "cuota_total": "420",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040945",
                "fecha_expedicion": "25-11-2025",
                "huella": "B63C2857A83778C9C3640B1C6DA46FAC533C926D7228194CF0FD450D58D52615"
            },
            "huella": "F00BAE9BDCA0D1F11EF4003782E7CE890B6A2338507FED6E09CB51E1314AE12C",
            "ultima_modificacion": "2025-11-25T17:54:07+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "cc3e17bf-1983-4103-b0d3-4217ba796cd3",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_AOR0000040945",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040945",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "21",
                    "cuota_repercutida": "420",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2420",
            "cuota_total": "420",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040943",
                "fecha_expedicion": "25-11-2025",
                "huella": "F509BDBCA45D384236BFC413153639D8491008D1229C0966536ECED326B93532"
            },
            "huella": "B63C2857A83778C9C3640B1C6DA46FAC533C926D7228194CF0FD450D58D52615",
            "ultima_modificacion": "2025-11-25T17:53:02+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "7a00d40e-93ad-4a1f-adc2-f793d4048f35",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_AOR0000040943",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040943",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2000",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040936",
                "fecha_expedicion": "25-11-2025",
                "huella": "ADB688F7F262D407AE6DDAAB10A20B42519A7A2DA70FE5C073C331057C296838"
            },
            "huella": "F509BDBCA45D384236BFC413153639D8491008D1229C0966536ECED326B93532",
            "ultima_modificacion": "2025-11-25T17:33:02+01:00",
            "estado": "Correcta"
        },
        {
            "uuid": "410c8bd7-0d6f-44e7-95bd-e7d5d522e2b8",
            "nif_emisor": "B75777847",
            "num_serie": "cb41_AOR0000040936",
            "fecha_expedicion": "25-11-2025",
            "subsanacion": "N",
            "rechazo_previo": "N",
            "tipo_factura": "F1",
            "descripcion": "Order OR0000040936",
            "nif_destinatario": "A15022510",
            "nombre_destinatario": "Juan Perez",
            "lineas": [
                {
                    "base_imponible": "2000",
                    "tipo_impositivo": "0",
                    "cuota_repercutida": "0",
                    "calificacion_operacion": "S1",
                    "clave_regimen": "01"
                }
            ],
            "importe_total": "2000",
            "cuota_total": "0",
            "encadenamiento": {
                "nif_emisor": "B75777847",
                "num_serie": "cb41_AOR0000040934",
                "fecha_expedicion": "25-11-2025",
                "huella": "6B4189611160FFD0682EB6E7BB5FBEBBC9DE0E77D3DFDFC163A963573BC3AFD6"
            },
            "huella": "ADB688F7F262D407AE6DDAAB10A20B42519A7A2DA70FE5C073C331057C296838",
            "ultima_modificacion": "2025-11-25T15:36:03+01:00",
            "estado": "Correcta"
        }
    ]
}

Responsible Declaration

Obtain the Verifacti responsible declaration document. The response will include a URL to access the responsible declaration document.

💻
Visit our API Reference to test this endpoint.

Endpoint

GET https://ecartpay.com/api/billings/providers/{id}/declaration
GET https://sandbox.ecartpay.com/api/billings/providers/{id}/declaration

Headers

Authorization: token

Path Parameters

id: The id of the billing provider.
- You can find the id of Verifacti by using the Get Billing Providers endpoint.

Examples

Request

curl --location 'https://sandbox.ecartpay.com/api/billings/providers/6917807fca828055fb9888e9/declaration' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI4MTE2MTI...............' \
--header 'Cookie: __cf_bm=jaMmdzGAd8EWGBZ8Yng9RKLvMYOqBjshWsB12qAL51Y-1764191560-1.0.1.1-.1mQTY4MBm98F8k1e.ROevaHR_60Wm3hsls8sPVIYqQseljqErWFpgO2w7fJC3ldwD3I2HnsRrYKCQZEjJ1mNggPAPkpIAYKWDCPO4cwhxw; lang=en'

Response

{
    "url": "https://storage.googleapis.com/verifacti_non_sensitive/declaracion/1.0.0.pdf",
    "sistema_informatico": {
        "nombre": "bilbabit",
        "id": "A1",
        "version": "1.0.0"
    }
}

Change Invoice Language

Use this endpoint to update the language the invoice PDF will be rendered in Ecart Pay Dashboard. The default language of a Verifactu invoice is in Spanish, but can be updated to Italian and French.

💻
Visit our API Reference to test this endpoint.

Endpoint

PATCH https://ecartpay.com/api/billings/{id}
PATCH https://sandbox.ecartpay.com/api/billings/{id}

Headers

Authorization: token

Path Parameters

id: The id of the invoice.

Examples

Request

curl --location --request PATCH 'https://sandbox.ecartpay.com/api/billings/69320e1cbd41d53a088aea9c' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=5wVdgddlHLAKiJOSAc7uHFVGOZXPCaHPHttIIlzlUw8-1765397222-1.0.1.1-JOL5ngWEHur.vwLvXkGIzsIpzjpb0FW46Jrr__Li.2Thhqfl9e_BZfazWDhXJoXKy3ptfCuIH.lZJtWzc2Ska8seW00_fZzag1nuUyVGmmc' \
--data '{
    "locales": "ES"
}'

curl --location --request PATCH 'https://sandbox.ecartpay.com/api/billings/69320e1cbd41d53a088aea9c' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=5wVdgddlHLAKiJOSAc7uHFVGOZXPCaHPHttIIlzlUw8-1765397222-1.0.1.1-JOL5ngWEHur.vwLvXkGIzsIpzjpb0FW46Jrr__Li.2Thhqfl9e_BZfazWDhXJoXKy3ptfCuIH.lZJtWzc2Ska8seW00_fZzag1nuUyVGmmc' \
--data '{
    "locales": "IT"
}'

curl --location --request PATCH 'https://sandbox.ecartpay.com/api/billings/69320e1cbd41d53a088aea9c' \
--header 'Authorization: eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4YTRjMzE1MGIyOGE5NTg0MzA1YTJhYSIsImFjY291bnRfaWQiOiI2OGE0YzMxNTBiMjhhOTU4NDMwNWEyYTYiLCJhY2NvdW50Ijp7ImVtYWlsIjoiaHVnby5tb3JpbkBlY2FydHBheS5jb20iLCJmaXJzdF9uYW1lIjoiSHVnbyIsImxhc3RfbmFtZSI6Ik1vcsOtbiIsInBob25lIjoiNTI......' \
--header 'Content-Type: application/json' \
--header 'Cookie: __cf_bm=5wVdgddlHLAKiJOSAc7uHFVGOZXPCaHPHttIIlzlUw8-1765397222-1.0.1.1-JOL5ngWEHur.vwLvXkGIzsIpzjpb0FW46Jrr__Li.2Thhqfl9e_BZfazWDhXJoXKy3ptfCuIH.lZJtWzc2Ska8seW00_fZzag1nuUyVGmmc' \
--data '{
    "locales": "FR"
}'

Response

{
    "locales": "ES"
}

{
    "locales": "IT"
}

{
    "locales": "FR"
}