{ "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.", "version": "0.1", "x-build-id": "Wsv2AMjek8TCuWtXq" }, "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 trên hoá đơn không có mã số thuế (dấu hiệu là cá nhân, không phải doanh nghiệp), trường tên và địa chỉ người mua sẽ bị ẩn khỏi kết quả để 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 } } }, "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 } } } } } } } } } }