Importar XML
Importa a Cefidia CFDI ya timbrados en otro sistema: archivos .xml o un solo .zip, cada archivo con su nombre y su contenido en base64, para un contribuyente, con o sin FIEL. Los mismos límites que Importar XML en la web: hasta 500 XML o un ZIP, 50 MB y 1 MB por XML; pero el cuerpo de una llamada es de 1 MiB, y en base64 caben unos 700 KB de archivos en total: para más, usa la web. Devuelve el id de la importación, su estado, queued, el número de archivos y la página donde se sigue; se procesa en segundo plano, y los CFDI que sean de este contribuyente aparecen después en list_documents, con origen external o como recibidos. Los archivos que no son CFDI, con sello inválido o de otro contribuyente se omiten y se reportan en esa página. Importar dos veces el mismo CFDI no lo duplica. No devuelve el contenido de los archivos. Errores: invalid_input con el motivo, forbidden.
Alcance (scope): cefidia:write · Características: Idempotente, Interactúa con el mundo exterior
Parámetros¶
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
taxpayer |
texto | No | Nombre o RFC del contribuyente. Se puede omitir si solo hay uno. |
files |
lista de objeto | Sí | Archivos .xml de CFDI, o un solo .zip, no una mezcla. |
Esquema de entrada (JSON Schema)¶
{
"$defs": {
"XmlFileInput": {
"additionalProperties": false,
"properties": {
"name": {
"description": "Nombre del archivo, con extensión .xml o .zip.",
"maxLength": 255,
"title": "Name",
"type": "string"
},
"content_base64": {
"description": "Contenido del archivo en base64.",
"maxLength": 1048576,
"title": "Content Base64",
"type": "string"
}
},
"required": [
"name",
"content_base64"
],
"title": "XmlFileInput",
"type": "object"
}
},
"additionalProperties": false,
"properties": {
"taxpayer": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Nombre o RFC del contribuyente. Se puede omitir si solo hay uno.",
"title": "Taxpayer"
},
"files": {
"description": "Archivos .xml de CFDI, o un solo .zip, no una mezcla.",
"items": {
"$ref": "#/$defs/XmlFileInput"
},
"maxItems": 500,
"title": "Files",
"type": "array"
}
},
"required": [
"files"
],
"title": "ImportXmlInput",
"type": "object"
}