Saltar a contenido

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"
}