Método: importar
El método importar del Webservice CFDI33 recibe datos para importarlos a uno o varios comprobantes.
-
La obligatoriedad de los campos se representa de la siguiente manera en la columna “Requerido”:
- Sí: el valor de este campo debe enviarse siempre.
- No: el valor de este campo puede enviarse o no.
- Condicional: el valor de este campo puede ser obligatorio o no, dependiendo de otros.
- Parámetros
-
Nombre Descripción Requerido usuario xs:string
Nombre de usuario registrado para el uso del WebService.
Sí password xs:string
Contraseña del usuario.
Sí archivoConector xs:base64Binary
Datos del archivo, este parametro deberá contener la información del archivo conector codificada en base64
Sí nombreArchivo xs:string
Nombre del archivo conector
No
Ejemplo de petición
Descargar este ejemplo
Regresa
- Este método retorna un tipo compuesto: importarResponse los atributos se describen en la siguiente tabla.
-
Atributos de importarResponse
Atributos de ResultadoCreacionNombre Descripción Requerido estatus xs:int
El código estatus de la operación, el detalle de códigos de respuesta se detalla en el anexo “Códigos de respuesta generales de encabezado”.
Sí mensaje xs:string
El mensaje de respuesta, detalla el estatus de la operación.
Sí resultadosCreacion Arreglo de ResultadoCreacion
Un arreglo de ResultadoCreacion, un tipo compuesto cuyos atributos se detallan en la tabla “Atributos de ResultadoCreacion”.
Sí Nombre Descripción Requerido estatus xs:int
Estatus del resultado de la creación del CFDI, para detalles de los códigos de estatus de creación consulte “Códigos de estatus de importación de CFDI”
Sí mensaje xs:string
Mensaje detallado de la operación realizada o descripción del error.
Sí uuid xs:string
Folio fiscal del CFDI.
Condicional folio xs:long
Folio comercial del CFDI.
Condicional serie xs:string
Serie comercial del CFDI.
Condicional emailReceptor xs:string
Dirección electrónica a donde se notifica la creación del CFDI.
Condicional
Ejemplo de respuesta
Descargar este ejemplo
-
Códigos de respuesta generales de encabezado
Los códigos de respuesta generales de encabezado pueden contener descripciones más específicas en el mensaje. Estos códigos se representarán en el primer nodo "estatus".
- 200 — El proceso de creación se ha completado correctamente.
- 500 — Han ocurrido errores que no han permitido completar el proceso. Reintentar.
- 501 — Error de conexión a la base de datos. Reintentar.
- 502 — Han ocurrido errores al intentar recuperar datos o almacenarlos en la base de datos.
- 503 — Se ha alcanzado el límite de licencias de acceso concurrente a base de datos.
- 601 — Error de autenticación, verifique usuario y contraseña.
- 602 — La cuenta de usuario se encuentra bloqueada.
- 603 — La contraseña de la cuenta ha expirado.
- 604 — Ha excedido el número máximo permitido de intentos de autenticación fallidos, la cuenta se bloqueará.
- 610 — La acción solicitada no está soportada en la implementación porque no se ha configurado para tal fin o no es posible realizarla. En el método importar significa que la implementación no tiene un Conector de importación de comprobantes configurado.
- 611 — No se han especificado todos los parámetros necesarios para realizar la operación. En el caso del método importar significa que el Conector de importación asignado a esta implementación no puede ser utilizado a través de este en este Webservice debido a limitaciones propias del conector.
- 612 — Archivo malformado. El formato de archivo o secuencia binaria no corresponde a la esperada.
- 613 — La secuencia numérica ha llegado al final.
- 620 — No tiene permiso para realizar la acción.
- 621 — Argumento no válido.
- 622 — Operación no soportada para la implementación.
- 623 — Datos no encontrados.
- 624 — Violación de restricción de unicidad.
- 625 — La acción no se puede completar porque requiere que se ejecute una acción previa.
- 626 — Error de configuración de la implementación.
- 630 — El contrato de la implementación ha expirado.
- 631 — La fecha de pago del contrato de la implementación ha expirado.
- 632 — Se ha superado el límite de uso justo para la implementación.
- 633 — La implementación se encuentra inactiva.
Representación del primer nodo "estatus"
-
Códigos de estatus de importación de CFDI
Cuando el primer nodo de estatus sea "200", la respuesta agregará el nodo "resultadosCreacion", dentro del cual se representará el segundo "estatus", que puede contener cualquiera los siguientes códigos
-
- 200 — Comprobante creado exitosamente
- 624 — Ya se había creado la factura
- 221 — Se actualizó la addenda
- 201 — Cancelar Factura
- 202 — ya se había cancelado
- 204 — No aplica cancelacion
- 213 — Cancelacion rechazada por el receptor
- 211 — Cancelacion en proceso
- 623 — datos no encontrados
- 610 — No se ha configurado plugin predeterminado
- 612 — archivo mal formado
- 632 — excede el numero de comprobantes por conector
- 630 — Se han agotado los folios contratados
- 622 — No se permite la generacion de comprobantes cancelados en versiones superiores a la 2.0
- 611 — datos incompletos
- 624 — reestriccion de unicidad
- 500 — error general
- 621 — argumento invalido
- 626 — error de configuracion
- 501 — error al conectar en base de datos
- 301 — validaciones adicionales XML malformado
- 625 — Se necesita una acción previa
- 622 — operacion no soportada
Representación del segundo nodo "estatus"
