{ "openapi": "3.0.1", "info": { "title": "Vietnam E-Invoice XML Normalizer", "description": "Chuẩn hoá file XML hoá đơn điện tử VAT Việt Nam (Viettel, VNPT, MISA, BKAV, Softdream, Thái Sơn...) về 1 định dạng JSON thống nhất, sẵn sàng cho AI Agent làm sổ sách. Phù hợp hoá đơn giữa doanh nghiệp (B2B) — for business-to-business invoices.", "version": "0.2", "x-build-id": "wIpHpFxUIlNtrhDVh" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/donerightlabs~vn-einvoice-xml-normalizer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-donerightlabs-vn-einvoice-xml-normalizer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/donerightlabs~vn-einvoice-xml-normalizer/runs": { "post": { "operationId": "runs-sync-donerightlabs-vn-einvoice-xml-normalizer", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/donerightlabs~vn-einvoice-xml-normalizer/run-sync": { "post": { "operationId": "run-sync-donerightlabs-vn-einvoice-xml-normalizer", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "invoices" ], "properties": { "invoices": { "title": "Danh sách hoá đơn XML", "type": "array", "description": "Mỗi mục là 1 hoá đơn điện tử VN dạng file XML gốc (không phải PDF/ảnh) mà bạn đã tự có sẵn. Đưa nội dung XML trực tiếp (xmlContent) hoặc link tải file XML (xmlUrl).", "default": [] }, "hideBuyerPersonalInfo": { "title": "Ẩn tên/địa chỉ người mua cá nhân", "type": "boolean", "description": "Khi bật (mặc định), nếu người mua là cá nhân lẻ — không có mã số thuế, mã số thuế là số định danh cá nhân 12 số, hoặc hoá đơn có số CCCD/hộ chiếu — thì tên, địa chỉ và các số định danh của người mua sẽ bị ẩn khỏi kết quả (cả dữ liệu thô) để bảo vệ thông tin cá nhân. Tắt đi nếu bạn cần đầy đủ thông tin này cho mục đích sổ sách của chính bạn.", "default": true }, "includeRawData": { "title": "Kèm dữ liệu thô đầy đủ", "type": "boolean", "description": "Kèm thêm toàn bộ các trường đọc được trực tiếp từ file XML gốc (chưa chuẩn hoá tên) vào kết quả, để bạn tự đối chiếu/kiểm tra. Nên giữ bật cho tới khi đã xác nhận kết quả chuẩn hoá đúng với hoá đơn thật của nhà cung cấp bạn dùng.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }