{
    "info": {
        "name": "API VeriFactu v2 · EN",
        "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "variable": [
        {
            "key": "URL_API",
            "value": "https://your-assigned-api.example"
        },
        {
            "key": "CLIENT_ID",
            "value": ""
        },
        {
            "key": "CLIENT_SECRET",
            "value": ""
        }
    ],
    "item": [
        {
            "name": "Authentication",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"auth_api\",\n    \"new_token\": \"new_token\",\n    \"grant_type\": \"client_credentials\",\n    \"client_id\" : \"{{CLIENT_ID}}\",\n    \"client_secret\" : \"{{CLIENT_SECRET}}\"\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Full invoice with VAT",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1005\",\n    \"json_data\": {\n        \"recipient\": {\n            \"irsId\": \"Q2826000H\",\n            \"name\": \"Agencia Tributaria\",\n            \"country\": \"ES\"\n        },\n        \"id\": {\n            \"number\": \"INT2601-0283\",\n            \"issuedTime\": \"2026-01-24\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-24\"\n        },\n        \"type\": \"F1\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 250.00,\n                \"rate\": 21,\n                \"amount\": 52.50,\n                \"vatKey\": \"01\"\n            },\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 100.00,\n                \"rate\": 21,\n                \"amount\": 21.00,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": 423.50,\n        \"amount\": 73.50\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "VAT-exempt invoice",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1005\",\n    \"json_data\": {\n        \"recipient\": {\n            \"irsId\": \"Q2826000H\",\n            \"name\": \"Agencia Tributaria\",\n            \"country\": \"ES\"\n        },\n        \"id\": {\n            \"number\": \"FN2601-0282\",\n            \"issuedTime\": \"2026-01-24\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-24\"\n        },\n        \"type\": \"F1\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E1\",\n                \"base\": 250,\n                \"rate\": 0,\n                \"amount\": 0,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": 250,\n        \"amount\": 0\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Simplified invoice",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1000\",\n    \"json_data\": {\n        \"id\": {\n            \"number\": \"FACT-2601-0022\",\n            \"issuedTime\": \"2026-01-20\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-20\"\n        },\n        \"type\": \"F2\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"vatKey\": \"01\",\n                \"base\": 0.75,\n                \"rate\": 21,\n                \"amount\": 0.16\n            }\n        ],\n        \"total\": 0.91,\n        \"amount\": 0.16\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Intra-EU invoice",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1001\",\n    \"json_data\": {\n        \"recipient\": {\n            \"id\": \"PT510014805\",\n            \"idType\": \"04\",\n            \"name\": \"Carten Marinu\",\n            \"country\": \"PT\"\n        },\n        \"id\": {\n            \"number\": \"FINT-2601-0023\",\n            \"issuedTime\": \"2026-01-20\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-20\"\n        },\n        \"type\": \"F1\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 250,\n                \"rate\": 0,\n                \"amount\": 0,\n                \"vatKey\": \"01\"\n            },\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 250,\n                \"rate\": 0,\n                \"amount\": 0,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": 500,\n        \"amount\": 0\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Invoice to a foreign customer",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1004\",\n    \"json_data\": {\n        \"recipient\": {\n            \"id\": \"88898888\",\n            \"idType\": \"05\",\n            \"name\": \"USA client\",\n            \"country\": \"US\"\n        },\n        \"id\": {\n            \"number\": \"IN2601-0283\",\n            \"issuedTime\": \"2026-01-20\"\n        },\n        \"description\": {\n            \"text\": \"HOY\",\n            \"operationDate\": \"2026-01-20\"\n        },\n        \"type\": \"F1\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 0.75,\n                \"rate\": 7,\n                \"amount\": 0.05,\n                \"vatKey\": \"01\",\n                \"tax\": \"03\"\n            },\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 250,\n                \"rate\": 10,\n                \"amount\": 25,\n                \"vatKey\": \"01\"\n            },\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": 0.75,\n                \"rate\": 7,\n                \"amount\": 0.05,\n                \"vatKey\": \"01\",\n                \"tax\": \"03\"\n            }\n        ],\n        \"total\": 276.6,\n        \"amount\": 25.1\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Equivalence surcharge",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"recipient\": {\n        \"irsId\": \"G36935931\",\n        \"name\": \"El Montuno SL\",\n        \"country\": \"ES\"\n    },\n    \"id\": {\n        \"number\": \"IN2602-0290\",\n        \"issuedTime\": \"2026-02-15\"\n    },\n    \"description\": {\n        \"text\": \"Documento verificable\",\n        \"operationDate\": \"2026-02-15\"\n    },\n    \"type\": \"F1\",\n    \"vatLines\": [\n        {\n            \"operation_rating\": \"S1\",\n            \"exempt_operation\": \"E0\",\n            \"base\": 250,\n            \"rate\": 21,\n            \"amount\": 52.5,\n            \"rate2\": 5.2,\n            \"amount2\": 13,\n            \"vatKey\": \"18\"\n        },\n        {\n            \"operation_rating\": \"S1\",\n            \"exempt_operation\": \"E0\",\n            \"base\": 100,\n            \"rate\": 4,\n            \"amount\": 4,\n            \"rate2\": 0.5,\n            \"amount2\": 0.5,\n            \"vatKey\": \"18\"\n        }\n    ],\n    \"total\": 420,\n    \"amount\": 70\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Rectifying invoice",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1001\",\n    \"json_data\": {\n        \"recipient\": {\n            \"irsId\": \"Q2826000H\",\n            \"name\": \"Agencia Tributaria\",\n            \"country\": \"ES\"\n        },\n        \"id\": {\n            \"number\": \"IC2601-0021\",\n            \"issuedTime\": \"2026-01-24\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-24\"\n        },\n        \"type\": \"R1\",\n        \"creditNote\": {\n            \"style\": \"I\",\n            \"ids\": [\n                {\n                    \"number\": \"FN2601-0282\",\n                    \"issuedTime\": \"2026-01-24\"\n                }\n            ]\n        },\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E1\",\n                \"base\": -250,\n                \"rate\": 0,\n                \"amount\": 0,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": -250,\n        \"amount\": 0\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Simplified rectifying invoice",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1001\",\n    \"json_data\": {\n        \"id\": {\n            \"number\": \"IC2601-0022\",\n            \"issuedTime\": \"2026-01-24\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable\",\n            \"operationDate\": \"2026-01-24\"\n        },\n        \"type\": \"R5\",\n        \"creditNote\": {\n            \"style\": \"I\",\n            \"ids\": [\n                {\n                    \"number\": \"TC1-2601-0022\",\n                    \"issuedTime\": \"2026-01-20\"\n                }\n            ]\n        },\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E0\",\n                \"base\": -0.75,\n                \"rate\": 21,\n                \"amount\": -0.16,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": -0.91,\n        \"amount\": -0.16\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Invoice record correction",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"send_invoice\",\n    \"id\": \"1001\",\n    \"json_data\": {\n        \"recipient\": {\n            \"irsId\": \"Q2826000H\",\n            \"name\": \"Agencia Tributaria\",\n            \"country\": \"ES\"\n        },\n        \"id\": {\n            \"number\": \"IN2601-0286\",\n            \"issuedTime\": \"2026-01-24\"\n        },\n        \"description\": {\n            \"text\": \"Documento verificable subsanado\",\n            \"operationDate\": \"2026-01-24\"\n        },\n        \"type\": \"F1\",\n        \"vatLines\": [\n            {\n                \"operation_rating\": \"S1\",\n                \"exempt_operation\": \"E1\",\n                \"base\": 250,\n                \"rate\": 0,\n                \"amount\": 0,\n                \"vatKey\": \"01\"\n            }\n        ],\n        \"total\": 250,\n        \"isFix\": \"1\",\n        \"amount\": 0\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Query statuses",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"check_docs\",\n    \"docs\": {\n        \"1\": {\n            \"queueId\": \"12\"\n        },\n        \"5\": {\n            \"queueId\": \"13\"\n        }\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Retrieve by reference",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"check_refferences\",\n    \"docs\": {\n        \"1\": {\n            \"ref\": \"FINT-2601-0023\"\n        },\n        \"2\": {\n            \"ref\": \"FINT-2601-0024\"\n        }\n    }\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Account summary",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/?action=account_summary",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it."
            }
        },
        {
            "name": "Responsible declaration",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/?action=declaracion_responsable",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it."
            }
        },
        {
            "name": "Webhook types",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/?action=webhooks_types",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it."
            }
        },
        {
            "name": "Create webhook",
            "request": {
                "method": "POST",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"setup_webhook\",\n    \"type\": 1,\n    \"url\": \"https://erp.dominio.dot/receipt\",\n    \"token\": \"ABC12345678...\"\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Configured webhooks",
            "request": {
                "method": "GET",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/?action=setup_webhooks",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it."
            }
        },
        {
            "name": "Update webhook",
            "request": {
                "method": "PUT",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it.",
                "body": {
                    "mode": "raw",
                    "raw": "{\n    \"action\": \"setup_webhook\",\n    \"url\": \"https://erp.dominio.dot/receipt2\",\n    \"token\": \"ABC12345678...\"\n}",
                    "options": {
                        "raw": {
                            "language": "json"
                        }
                    }
                }
            }
        },
        {
            "name": "Delete webhook",
            "request": {
                "method": "DELETE",
                "header": [
                    {
                        "key": "Content-Type",
                        "value": "application/json"
                    }
                ],
                "url": "{{URL_API}}/vapi/v2/?action=webhook&id={webhook_id}",
                "description": "Examples based on the published API v2 documentation. Replace URL_API with your assigned environment. Use test data only. Confirm the exact token header with support; the public reference does not specify it."
            }
        }
    ]
}