{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Timbrar CFDI 4.0","description":"QRwey! API es un API que te permite intenciones de autofactura con QRs para ser leidos en la App de QRwey!.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"timbrar-cfdi-40","__idx":0},"children":["Timbrar CFDI 4.0"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["El endpoint de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["timbrado de CFDI 4.0"]}," permite a los clientes de QRwey! generar y timbrar"," ","facturas de ingreso directamente a través del API, sin necesidad de generar un código QR previo."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este flujo es ideal cuando el sistema del cliente controla completamente los datos de la"," ","transacción y del receptor."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /v1/qrs/invoices\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (DEV):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api-dev.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Host (PROD):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://api.qrwey.com\n"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"headers-requeridos","__idx":2},"children":["Headers requeridos"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer {{access_token}}\nContent-Type: application/json\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-body","__idx":3},"children":["Request body"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-principales","__idx":4},"children":["Campos principales"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador de la venta, generado por el cliente"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["series"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Serie del comprobante (opcional)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de emisión en formato ISO 8601 (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expedition_zip_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código postal del lugar de expedición (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total de la operación (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subtotal antes de impuestos (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Moneda (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]},") (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exchange_rate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tasa de cambio, necesario si ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," es diferente a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MXN"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_payment_form"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forma de pago SAT (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["04"]}," Tarjeta de crédito)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_payment_method"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Método de pago SAT (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUE"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PPD"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type_of_receipt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de comprobante: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["I"]}," para factura de ingreso (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["export_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código de exportación SAT (ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]}," No aplica) (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"conceptos--items-","__idx":5},"children":["Conceptos (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada elemento representa un concepto del CFDI:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sku"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identificador interno del producto"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del concepto (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Importe del concepto (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["quantity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cantidad (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["discount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descuento aplicado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_unit_key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de unidad SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LTR"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unit_price"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Precio unitario (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_product_service_key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave producto/servicio SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_tax_object_key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Objeto de impuesto SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["02"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Impuestos aplicables al concepto"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"impuestos-del-concepto--taxes-","__idx":6},"children":["Impuestos del concepto (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de impuesto: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Traslado"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retencion"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave del impuesto SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["002"]}," IVA (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["factor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de factor: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tasa"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Cuota"]}," o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Exento"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tasa o cuota del impuesto, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.160000"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxable_base"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base imponible (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monto del impuesto (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"emisor--issuer-","__idx":7},"children":["Emisor (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuer"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del emisor (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del emisor (opcional, ver lógica de resolución)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_regime_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave del régimen fiscal SAT (opcional, ver lógica de resolución)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_credentials"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Credenciales del CSD en formato base64 (opcional)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"lógica-de-resolución-del-emisor","__idx":8},"children":["Lógica de resolución del emisor"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["El campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}," es el único requerido en el objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuer"]},". El sistema resuelve"," ","el emisor con la siguiente lógica:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Si se proporciona ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_name"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_regime_code"]}]},": el sistema auto-crea o actualiza"," ","los registros de InvoiceData, Merchant y CSD (si ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_credentials"]}," también está presente)."," ","Esto permite al cliente registrar un emisor al vuelo durante el timbrado."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Si solo se proporciona ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}]},": el sistema busca un emisor activo existente registrado"," ","con ese RFC en la cuenta del customer."]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ Si usas la opción 2 y no existe un emisor activo con ese RFC, la operación fallará con error 404."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"credenciales-sat--sat_credentials-","__idx":9},"children":["Credenciales SAT (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sat_credentials"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base64Cer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certificado CSD codificado en base64"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base64Key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Llave privada CSD codificada en base64"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["password"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contraseña de la llave privada"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"receptor--recipient-","__idx":10},"children":["Receptor (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]},")"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del receptor (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del receptor (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zip_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Código postal del domicilio fiscal (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_regime_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave del régimen fiscal SAT (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfdi_use_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave de uso del CFDI SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["G03"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Correo electrónico del receptor (opcional)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cfdis-relacionados--related_cfdis----opcional","__idx":11},"children":["CFDIs relacionados (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["related_cfdis"]},") - Opcional"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tipo_relacion"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tipo de relación entre CFDIs, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["04"]}," Sustitución"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfdis"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lista de UUIDs de los CFDIs relacionados"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"información-global--global_info----opcional","__idx":12},"children":["Información global (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["global_info"]},") - Opcional"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para comprobantes globales de operaciones con público en general:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["periodicity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Periodicidad SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["04"]}," Mensual"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["months"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mes SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12"]}," Diciembre"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["year"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Anio a cuatro dígitos"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplo-de-request-dev","__idx":13},"children":["Ejemplo de request (DEV)"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://api-dev.qrwey.com/v1/qrs/invoices\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"sale_id\": \"fcd68791-6a27-412f-a50f-8d47b7bc34d2\",\n    \"series\": \"A\",\n    \"date\": \"2026-03-19T14:30:00\",\n    \"expedition_zip_code\": \"06600\",\n    \"amount\": 1160.00,\n    \"subtotal\": 1000.00,\n    \"currency\": \"MXN\",\n    \"exchange_rate\": 1.0,\n    \"sat_payment_form\": \"04\",\n    \"sat_payment_method\": \"PUE\",\n    \"type_of_receipt\": \"I\",\n    \"export_code\": \"01\",\n    \"items\": [\n      {\n        \"sku\": \"GAS87\",\n        \"description\": \"Gasolina Magna\",\n        \"amount\": 1000.00,\n        \"quantity\": 49.210,\n        \"discount\": 0.00,\n        \"sat_unit_key\": \"LTR\",\n        \"unit_price\": 20.321,\n        \"sat_product_service_key\": \"15101515\",\n        \"sat_tax_object_key\": \"02\",\n        \"taxes\": [\n          {\n            \"type\": \"Traslado\",\n            \"tax\": \"002\",\n            \"factor\": \"Tasa\",\n            \"rate\": \"0.160000\",\n            \"taxable_base\": 1000.00,\n            \"amount\": 160.00\n          }\n        ]\n      }\n    ],\n    \"issuer\": {\n      \"rfc\": \"FUNK671228PH6\",\n      \"business_name\": \"KARLA FUENTE NOLASCO\",\n      \"tax_regime_code\": \"601\"\n    },\n    \"recipient\": {\n      \"rfc\": \"EKU9003173C9\",\n      \"business_name\": \"ESCUELA KEMPER URGATE\",\n      \"zip_code\": \"42501\",\n      \"tax_regime_code\": \"601\",\n      \"cfdi_use_code\": \"G03\",\n      \"email\": \"receptor@ejemplo.com\"\n    },\n    \"related_cfdis\": null,\n    \"global_info\": null\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"respuesta","__idx":14},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"invoiceStatus\": \"GENERATED\",\n  \"folioUuid\": \"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\",\n  \"sourceTaxId\": \"FUNK671228PH6\",\n  \"sourceLegalName\": \"KARLA FUENTE NOLASCO\",\n  \"targetTaxId\": \"EKU9003173C9\",\n  \"targetLegalName\": \"ESCUELA KEMPER URGATE\",\n  \"subtotal\": 1000.00,\n  \"iva\": 160.00,\n  \"total\": 1160.00,\n  \"invoiceDate\": \"2026-03-19T14:30:00Z\",\n  \"invoiceError\": null,\n  \"base64Xml\": \"PD94bWwgdmVyc2lvbj0iMS4wIiBlb...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-de-la-respuesta","__idx":15},"children":["Campos de la respuesta"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Campo"},"children":["Campo"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Descripción"},"children":["Descripción"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceStatus"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estado del timbrado: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folioUuid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID fiscal asignado por el SAT"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceTaxId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del emisor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sourceLegalName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del emisor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetTaxId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del receptor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["targetLegalName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Razón social del receptor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtotal"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Subtotal del CFDI"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iva"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["IVA calculado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Total del CFDI"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha de timbrado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceError"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Descripción del error (solo cuando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceStatus"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]},", de lo contrario es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base64Xml"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["XML timbrado codificado en base64 (solo cuando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoiceStatus"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GENERATED"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":16},"children":["Errores comunes"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Código"},"children":["Código"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Motivo"},"children":["Motivo"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campos requeridos faltantes, datos del CFDI invalidos"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token inválido o expirado"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Emisor no encontrado o no tiene llaves CSD configuradas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["La venta ya fue facturada anteriormente (duplicado por ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_id"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Error de reglas de negocio del SAT (RFC inválido, régimen incorrecto, etc.)"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Consulta: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/error-handling"},"children":["Manejo de errores"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"buenas-prácticas","__idx":17},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifica que el emisor tenga llaves CSD configuradas antes de timbrar"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sale_id"]}," como referencia interna para correlacionar con tu sistema"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valida que los campos del receptor (RFC, razón social, código postal, régimen fiscal) sean correctos segun la Constancia de Situación Fiscal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Para emisores recurrentes, registra el emisor previamente y usa solo el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}," en el request"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Guarda el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folioUuid"]}," y las URLs del XML/PDF para tu registro contable"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":18},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Genera notas de crédito: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/credit-notes"},"children":["Notas de crédito"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Genera complementos de pago: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payment-complements"},"children":["Complementos de pago"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Vuelve al índice: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/customer-portal"},"children":["Gestión de Clientes"]}]}]}]},"headings":[{"value":"Timbrar CFDI 4.0","id":"timbrar-cfdi-40","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Headers requeridos","id":"headers-requeridos","depth":2},{"value":"Request body","id":"request-body","depth":2},{"value":"Campos principales","id":"campos-principales","depth":3},{"value":"Conceptos ( items )","id":"conceptos--items-","depth":3},{"value":"Impuestos del concepto ( taxes )","id":"impuestos-del-concepto--taxes-","depth":3},{"value":"Emisor ( issuer )","id":"emisor--issuer-","depth":3},{"value":"Lógica de resolución del emisor","id":"lógica-de-resolución-del-emisor","depth":4},{"value":"Credenciales SAT ( sat_credentials )","id":"credenciales-sat--sat_credentials-","depth":4},{"value":"Receptor ( recipient )","id":"receptor--recipient-","depth":3},{"value":"CFDIs relacionados ( related_cfdis ) - Opcional","id":"cfdis-relacionados--related_cfdis----opcional","depth":3},{"value":"Información global ( global_info ) - Opcional","id":"información-global--global_info----opcional","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":2},{"value":"Respuesta","id":"respuesta","depth":2},{"value":"Campos de la respuesta","id":"campos-de-la-respuesta","depth":3},{"value":"Errores comunes","id":"errores-comunes","depth":2},{"value":"Buenas prácticas","id":"buenas-prácticas","depth":2},{"value":"¿Qué sigue?","id":"qué-sigue","depth":2}],"frontmatter":{"title":"Timbrar CFDI 4.0","description":"Generar y timbrar una factura de ingreso (tipo I) CFDI 4.0 directamente desde el API de QRwey!","seo":{"title":"Timbrar CFDI 4.0"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/stamp-cfdi","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}