{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Complementos de pago","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":"complementos-de-pago","__idx":0},"children":["Complementos de pago"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Un ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["complemento de pago"]}," es un CFDI de tipo ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Pago (P)"]}," que documenta la recepción"," ","de un pago asociado a una factura que fue emitida con método de pago ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PPD"]}," ","(Pago en parcialidades o diferido)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Este comprobante es obligatorio cuando el pago no se realiza en el momento de"," ","la emisión de la factura original."]},{"$$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/payment-complements\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":"diferencias-con-la-factura-de-ingreso","__idx":3},"children":["Diferencias con la factura de ingreso"]},{"$$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":"Valor para complemento de pago"},"children":["Valor para complemento de pago"]}]}]},{"$$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_of_receipt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}," (Pago)"]}]},{"$$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":["Debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]}]},{"$$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":["Debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]}]},{"$$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":["Debe ser ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XXX"]}," (sin moneda)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["items"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No se incluye o se deja vacío"]}]},{"$$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":["No se incluye"]}]},{"$$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":["No se incluye"]}]},{"$$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":["No se incluye"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement.payment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Requerido"]},". Contiene los datos del pago recibido"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ El objeto ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement.payment"]}," es ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["obligatorio"]},". Sin el, la operación fallará."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-body","__idx":4},"children":["Request body"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"campos-principales","__idx":5},"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 operación"]}]},{"$$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 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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]}," (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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}]}," (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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XXX"]}]}," (requerido)"]}]},{"$$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":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]}," (Pago) (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, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01"]}," (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issuer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos del emisor (ver ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["lógica de resolución"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Datos del receptor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Objeto con los datos del pago (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"datos-del-pago--complementpayment-","__idx":6},"children":["Datos del pago (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement.payment"]},")"]},{"$$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":["payment_date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fecha en que se recibio el pago, formato ISO 8601 (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_form"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forma de pago SAT, ej. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["03"]}," Transferencia (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 del pago, 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 del pago"]}]},{"$$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 total del pago recibido (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["operation_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de operación o referencia bancaria"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_bank_rfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del banco emisor del pago"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cuenta bancaria del pagador"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target_bank_rfc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["RFC del banco receptor del pago"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["target_account"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cuenta bancaria del receptor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["related_documents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lista de documentos relacionados (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"documentos-relacionados--related_documents-","__idx":7},"children":["Documentos relacionados (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["related_documents"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada documento relacionado vincula el pago con una factura PPD emitida previamente:"]},{"$$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":["uuid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID fiscal del CFDI original (requerido)"]}]},{"$$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 CFDI original"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folio"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Folio del CFDI original"]}]},{"$$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 del CFDI original (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 del documento"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["installment_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Número de parcialidad (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["previous_balance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saldo anterior (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount_paid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Monto pagado en esta parcialidad (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["remaining_balance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Saldo restante después del pago (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_object_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Clave del objeto de impuesto, 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 del documento relacionado (requerido cuando ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tax_object_code"]}," es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["02"]},")"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"impuestos-del-documento-relacionado--taxes-","__idx":8},"children":["Impuestos del documento relacionado (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxes"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada elemento representa un impuesto aplicable al documento pagado. Estos se generan como"," ","nodos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ImpuestosDR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ImpuestosP"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Totales"]}," en el XML del complemento de pago."]},{"$$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: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Traslado"]}," (traslado) o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retencion"]}," (retención) (requerido)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["base"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Base imponible proporcional al pago (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"]}]}]},{"$$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 proporcional al pago (requerido)"]}]}]}]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ Los impuestos de cada documento se acumulan automáticamente para generar los nodos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ImpuestosP"]}," (a nivel de pago) y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Totales"]}," (a nivel de complemento) en el XML timbrado."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"ejemplo-de-request-dev","__idx":9},"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/payment-complements\" \\\n  -H \"Authorization: Bearer {{access_token}}\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"sale_id\": \"pago-001-2026\",\n    \"date\": \"2026-03-19T16:00:00\",\n    \"expedition_zip_code\": \"06600\",\n    \"amount\": 0,\n    \"subtotal\": 0,\n    \"currency\": \"XXX\",\n    \"type_of_receipt\": \"P\",\n    \"export_code\": \"01\",\n    \"issuer\": {\n      \"rfc\": \"FUNK671228PH6\"\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\": \"CP01\",\n      \"email\": \"receptor@ejemplo.com\"\n    },\n    \"complement\": {\n      \"payment\": {\n        \"payment_date\": \"2026-03-18T12:00:00\",\n        \"payment_form\": \"03\",\n        \"currency\": \"MXN\",\n        \"exchange_rate\": 1.0,\n        \"amount\": 5800.00,\n        \"operation_number\": \"REF-2026-0319-001\",\n        \"source_bank_rfc\": \"BBA930311SEA\",\n        \"source_account\": \"0123456789\",\n        \"target_bank_rfc\": \"BNM840515VB1\",\n        \"target_account\": \"9876543210\",\n        \"related_documents\": [\n          {\n            \"uuid\": \"A1B2C3D4-E5F6-7890-ABCD-EF1234567890\",\n            \"series\": \"A\",\n            \"folio\": \"1001\",\n            \"currency\": \"MXN\",\n            \"exchange_rate\": 1.0,\n            \"installment_number\": 1,\n            \"previous_balance\": 11600.00,\n            \"amount_paid\": 5800.00,\n            \"remaining_balance\": 5800.00,\n            \"tax_object_code\": \"02\",\n            \"taxes\": [\n              {\n                \"type\": \"Traslado\",\n                \"base\": 5000.00,\n                \"tax\": \"002\",\n                \"factor\": \"Tasa\",\n                \"rate\": \"0.160000\",\n                \"amount\": 800.00\n              }\n            ]\n          }\n        ]\n      }\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":10},"children":["Respuesta"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"invoiceStatus\": \"GENERATED\",\n  \"folioUuid\": \"R1S2T3U4-V5W6-7890-XYZA-BC1234567890\",\n  \"sourceTaxId\": \"FUNK671228PH6\",\n  \"sourceLegalName\": \"KARLA FUENTE NOLASCO\",\n  \"targetTaxId\": \"EKU9003173C9\",\n  \"targetLegalName\": \"ESCUELA KEMPER URGATE\",\n  \"subtotal\": 0,\n  \"iva\": 0,\n  \"total\": 0,\n  \"invoiceDate\": \"2026-03-19T16:00:00Z\",\n  \"invoiceError\": null,\n  \"base64Xml\": \"PD94bWwgdmVyc2lvbj0iMS4wIiBlb...\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["⚠️ En el complemento de pago, los campos ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subtotal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iva"]}," y ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["total"]}," siempre son ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},". El monto real del pago esta documentado en el nodo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement.payment"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["La estructura de la respuesta es la misma que para ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]},". Consulta esa guia para el detalle de todos los campos."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"errores-comunes","__idx":11},"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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type_of_receipt"]}," no es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["complement.payment"]}," ausente, o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["related_documents"]}," vacío"]}]},{"$$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 sin llaves CSD"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID del documento relacionado inválido, montos inconsistentes, o reglas del SAT no cumplidas"]}]}]}]}]},{"$$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":12},"children":["Buenas prácticas"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Emite el complemento de pago dentro de los plazos establecidos por el SAT (generalmente el día 17 del mes siguiente)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verifica que el UUID del documento relacionado corresponda a un CFDI con método de pago PPD"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["El ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["installment_number"]}," debe ser secuencial: primer pago = 1, segundo = 2, etc."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valida que ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["previous_balance - amount_paid = remaining_balance"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["El ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cfdi_use_code"]}," del receptor para complementos de pago normalmente es ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CP01"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Usa ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_form"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["03"]}," (Transferencia electrónica) cuando el pago sea por transferencia bancaria"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Conserva el ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["folioUuid"]}," para vincular el complemento con la factura original en tu contabilidad"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"qué-sigue","__idx":13},"children":["¿Qué sigue?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Emite facturas de ingreso: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/stamp-cfdi"},"children":["Timbrar CFDI 4.0"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Emite notas de crédito: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/credit-notes"},"children":["Notas de crédito"]}]},{"$$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":"Complementos de pago","id":"complementos-de-pago","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Headers requeridos","id":"headers-requeridos","depth":2},{"value":"Diferencias con la factura de ingreso","id":"diferencias-con-la-factura-de-ingreso","depth":2},{"value":"Request body","id":"request-body","depth":2},{"value":"Campos principales","id":"campos-principales","depth":3},{"value":"Datos del pago ( complement.payment )","id":"datos-del-pago--complementpayment-","depth":3},{"value":"Documentos relacionados ( related_documents )","id":"documentos-relacionados--related_documents-","depth":3},{"value":"Impuestos del documento relacionado ( taxes )","id":"impuestos-del-documento-relacionado--taxes-","depth":3},{"value":"Ejemplo de request (DEV)","id":"ejemplo-de-request-dev","depth":2},{"value":"Respuesta","id":"respuesta","depth":2},{"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":"Complementos de pago","description":"Generar y timbrar complementos de pago (CFDI tipo P) a través del API de QRwey!","seo":{"title":"Complementos de pago"}},"lastModified":"2026-04-22T23:50:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payment-complements","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}