Método: crear
El método crear del Web Service CFDI crea uno o varios CFDI.
-
La obligatoriedad de los campos está representada 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.
- Parametros:
-
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í comprobantes Arreglo de CFDI
Array del tipo complejo CFDI, descrito en la tabla “Atributos de CFDI”.
Sí
Atributos del tipo complejo CFDI:Los atributos marcados en cursiva ( italic ) no necesitan ser enviados por el WebService, se generan o se obtienen de otra fuente en el servidor.
Nombre Descripción Requerido folio xs:long
El folio comercial del CFDI.
Condicional nombreSerie xs:string
El nombre de la serie de CFDI.
Condicional etiquetaComprobante xs:string
Indica de que tipo es el CFDI (ej: Factura, Prefactura, Nota de Crédito).
Sí nombreEmisor xs:string
Razón social de quién emite el CFDI.
Sí rfcEmisor xs:string
R. F. C. del emisor.
Sí calleFiscalEmisor xs:string
Calle del domicilio fiscal del emisor.
Sí numeroExteriorFiscalEmisor xs:string
Número exterior del domicilio fiscal del emisor.
Sí numeroInteriorFiscalEmisor xs:string
Número interior del domicilio fiscal del emisor.
No coloniaFiscalEmisor xs:string
Colonia del domicilio fiscal del emisor.
No ciudadFiscalEmisor xs:string
Ciudad donde se encuentra el domicilio fiscal del emisor.
No referenciaFiscalEmisor xs:string
Rasgo geográfico útil para ubicar el domicilio fiscal del emisor.
No municipioFiscalEmisor xs:string
Municipio dónde se encuentra el domicilio fiscal del emisor.
No estadoFiscalEmisor xs:string
Estado dónde se encuentra el domicilio fiscal del emisor.
No paisFiscalEmisor xs:string
País dónde se encuentra el domicilio fiscal del emisor.
No codigoPostalFiscalEmisor xs:string
Código postal del domicilio fiscal del emisor.
No calleExpedicionEmisor xs:string
Calle del domicilio de expedición del emisor.
No numeroExpedicionEmisor xs:string
Número exterior del domicilio de expedición del emisor.
No numeroInteriorExpedicionEmisor xs:string
Número interior del domicilio de expedición del emisor.
No coloniaExpedicionEmisor xs:string
Colonia del domicilio de expedición del emisor.
No ciudadExpedicionEmisor xs:string
Ciudad donde se encuentra el domicilio de expedición del emisor.
No referenciaExpedicionEmisor xs:string
Rasgo geográfico útil para ubicar el domicilio de expedición del emisor.
No municipioExpedicionEmisor xs:string
Municipio dónde se encuentra el domicilio de expedición del emisor.
No estadoExpedicionEmisor xs:string
Estado dónde se encuentra el domicilio de expedición del emisor.
No paisExpedicionEmisor xs:string
País dónde se encuentra el domicilio de expedición del emisor.
No codigoPostalExpedicionEmisor xs:string
Código postal del domicilio de expedición del emisor.
No nombreCliente xs:string
Razón social del receptor de la factura
Sí rfcCliente xs:string
R. F. C. del receptor.
Sí emailCliente xs:string
Dirección electrónica del receptor.
No calleFiscalEmisor xs:string
Calle del domicilio fiscal del receptor.
No numeroExteriorFiscalCliente xs:string
Número exterior del domicilio fiscal del receptor.
No numeroInteriorFiscalCliente xs:string
Número interior del domicilio fiscal del receptor.
No coloniaFiscalCliente xs:string
Colonia del domicilio fiscal del receptor.
No ciudadFiscalCliente xs:string
Ciudad donde se encuentra el domicilio fiscal del receptor.
No referenciaFiscalCliente xs:string
Rasgo geográfico útil para ubicar el domicilio fiscal del receptor.
No municipioFiscalCliente xs:string
Municipio dónde se encuentra el domicilio fiscal del receptor.
No estadoFiscalCliente xs:string
Estado dónde se encuentra el domicilio fiscal del receptor.
No paisFiscalCliente xs:string
País dónde se encuentra el domicilio fiscal del receptor.
No codigoPostalFiscalCliente xs:string
Código postal del domicilio fiscal del receptor.
No nombreClienteEmbarque xs:string
Nombre de la persona de contacto por parte del receptor del lugar de entrega.
No rfcClienteEmbarque xs:string
R. F. C. del contacto por parte del receptor del lugar de entrega.
No calleClienteEmbarque xs:string
Calle del domicilio del lugar de embarque.
No numeroExteriorClienteEmbarque xs:string
Número exterior del domicilio del lugar de embarque.
No numeroInteriorEmbarqueCliente xs:string
Número interior del domicilio del lugar de embarque.
No coloniaEmbarqueCliente xs:string
Colonia del domicilio del lugar de embarque.
No ciudadEmbarqueCliente xs:string
Ciudad donde se encuentra el domicilio del lugar de embarque.
No referenciaEmbarqueCliente xs:string
Rasgo geográfico útil para ubicar el domicilio del lugar de embarque.
No municipioEmbarqueCliente xs:string
Municipio dónde se encuentra el domicilio del lugar de embarque.
No estadoEmbarqueCliente xs:string
Estado dónde se encuentra el domicilio del lugar de embarque.
No paisEmbarqueCliente xs:string
País dónde se encuentra el domicilio del lugar de embarque.
No codigoPostalEmbarqueCliente xs:string
Código postal del domicilio del lugar de embarque.
No fechaEmision xs:dateTime
Fecha de emisión del CFDI.
Sí condicionesPago xs:string
Expresa las condiciones comerciales para el pago del CFDI.
No fechaPago xs:date
Fecha en la que se realizará el pago del CFDI.
Sí observacionesPago xs:string
Notas sobre el pago de los bienes amparados bajo el CFDI.
No notasFactura xs:string
Texto libre para añadir notas sobre el CFDI.
No autorizada xs:boolean
Bandera que indica si el CFDI ha sido autorizado.
Sí cancelada xs:boolean
Bandera que indica si el CFDI está cancelado.
Sí xml xs:base64Binary
Arreglo de bytes que conforman el CFDI.
Sí formaPago xs:string
Precisa la forma de pago que aplica para el CFDI.
Sí metodoPago xs:string
Expresa el método de pago de los bienes amparados por el CFDI.
No cadenaOriginal xs:string
Cadena formada por la serie de todos los datos que conforman el CFDI.
Sí selloDigital xs:string
Cadena que representa la garantía de la vinculación entre la identidad de un sujeto o entidad y su clave pública.
Sí numeroSerieCsd xs:string
Número de serie del certificado de sello dígital.
Sí numeroAprobacionSerie xs:long
Número de aprobación de la serie del certificado de sello digital.
Sí yearAprobacionSerie xs:long
Año en que se aprobo la serie del certificado de sello digital.
Sí monedaSimbolo xs:string
Símbolo de la moneda que se usa en el CFDI.
No monedaNombre xs:string
Nombre de la moneda usada en el CFDI.
No monedaTipoCambio xs:decimal
Tipo de cambio en el que se expresa la moneda usada en el CFDI.
No subtotal xs:decimal
Cantidad que expresa el subtotal de la suma de los bienes amparados bajo el CFDI.
Sí importeIva xs:decimal
Monto total de IVA sobre los bienes amparados bajo el CFDI.
Sí importeIeps xs:decimal
Monto total de IEPS sobre los bienes amparados bajo el CFDI.
Sí importeRetIva xs:decimal
Monto total de retención de IVA sobre los bienes amparados bajo el CFDI.
Sí importeRetIsr xs:decimal
Monto total de retención de IEPS sobre los bienes amparados bajo el CFDI.
Sí importeDescuentos xs:decimal
Monto total de descuentosobre los bienes amparados bajo el CFDI.
No importeTotal xs:decimal
Monto total que expresa el balance entre el subtotal y los demás importes del CFDI.
Sí cfdVersion xs:string
Versión del CFDI.
No tfdVersion xs:string
Versión del timbre fiscal digital.
No tfdUuid xs:string
Identificador del timbre fiscal digital.
No tfdCadenaOriginal xs:string
Cadena que contiene todos los elementos que conforman el timbre fiscal digital.
No tfdSelloDigital xs:string
Garantía de la vinculación entre la identidad de un sujeto o entidad y su clave pública.
No tfdCertificadoSat xs:string
Número de serie del certificado de sello digital asignado por el provedor autorizado de certificación.
No detalleCFDI Arreglo de DetalleCFDI
Contiene el detalle de los bienes amparados bajo el CFDI.
Sí DetalleCampoDinamico Arreglo deCampoDinamico
Contiene los datos de los campos dinámicos específicos de una implementación.
Condicional
Atributos del tipo complejo DetalleCFDINombre Descripción Requerido concepto xs:string
Descripción del bien amparado bajo el CFDI.
Sí unidad xs:string
Unidad de medida en la que se expresa el bien.
Sí cantidad xs:decimal
Cantidad de bienes expresados bajo el mismo concepto.
Sí precioUnitario xs:decimal
Valor unitario del bien.
Sí tasaIva xs:decimal
Tasa unitaria de IVA del bien.
No tasaRetencionIva xs:decimal
Monto de retención de IVA del bien.
No tasaIeps xs:decimal
Tasa unitaria de IEPS del bien.
No montoIeps xs:decimal
Monto de IEPS del bien.
No tasaRentencionIsr xs:decimal
Tasa unitaria de retención ISR del bien.
No montoRetencionIsr xs:decimal
Monto de retención ISR del bien.
No tasaDescuento xs:decimal
Tasa de descuento del bien.
No montoDescuento xs:decimal
Monto de descuento del bien.
No importe xs:decimal
Importe correspondiente al bien.
Sí cuentaPredial xs:string
Número de cuenta predial con el que fue registrado el inmueble, en el sistema catastral de la entidad federativa de que trate (solo para bienes inmuebles de un recibo de arrendamiento).
No codigo xs:string
Código con el que se identifica comercialmente el bien.
No comment xs:string
Comentario adicional sobre el bien o servicio que se factura.
No informacionAduanera Arreglo de InformacionAduanera
Información de aduana (aplica solamente cuando el bien es una importación que pasó por aduana).
No
Nota: Los datos del emisor se obtienen de la implementación, no se piden.
Atributos del tipo complejo CampoDinamicoNombre Descripción Requerido campo xs:string
Nombre del campo dinámico.
Sí valor xs:string
Contiene el valor del campo dinámico.
Sí Nombre Descripción Requerido numeroPedimento xs:string
El número de pedimento correspondiente al bien.
Sí aduana xs:string
Nombre de la aduana.
Sí fechaAduana xs:date
La fecha en la que el bien pasó por la aduana.
Sí
Ejemplo de petición:
Descargar este ejemplo
Regresa:
- Este método retorna un tipo compuesto: RespuestaCreacion los atributos se describen en la siguiente tabla.
-
Atributos de RespuestaCreacionNombre Descripción Requerido status 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”. Para el método “importar” consulte además los códigos de encabezado específicos de este método en la tabla “Códigos de estatus de importación de CFDI”
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 status 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
El folio comercial del CFDI.
Condicional serie xs:string
Serie comercial del CFDI.
Condicional email xs:string
Dirección electrónica a donde se notifica la creación del CFDI.
Condicional operacion xs:int
Indica la operación sobre el CFDI. Veáse “Códigos de operación para la importación de CFDI”.
Sí
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
- 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á sooportada 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