Crear Factura de Recepción de Pago

Crea un comprobante fiscal de Comprobantes de Pago

Definición

POST https://api.avanto.mx/v1/sales

Información

Los campos marcados con "*" son datos requeridos.

Importante

Únicamente los comprobantes con método de pago "PPD - Pago Parcialidades o Diferido"

Recursos

Argumento	Tipo	Default	Descripción
company_subsidiary_id *	int	0	Sucursal de empresa emisora
type *	tinyint	4	Tipo de comprobante: 4. Recepción de Pago
accounting_effect *	char	"P"	Efecto contable: I. Ingreso, E. Egreso, P. Pago, T. Traslado
emitted *	datetime	datetime()	Fecha y hora de emisión
subsidiary_id *	int	0	ID de la sucursal del cliente (receptor)
carrier	varchar	""	Transportista: FedEx, UPS, DHL (requiere catálogo)
shipping	varchar	""	Dato de envío
assigned_to *	int	0	Asignado a/ Vendedor (ID de usuario)
currency_id *	int	0	ID de la moneda
exchange_rate *	decimal	0.000	Tipo de cambio
notes	text	""	Notas adicionales
tips	decimal	0.000	Importe de servicios adicionales.
balance	decimal	0.000	Saldo restante
cfdi_regimenfiscal *	varchar	""	(CFDIDETAILS) Emisor.RegimenFiscal
cfdi_usocfdi *	varchar	""	(CFDIDETAILS) Receptor.UsoCFDI
cfdiPayments.fechapago *	datetime	""	Fecha del pago
cfdiPayments.formadepagop *	varchar	""	Forma de pago
cfdiPayments.monedap *	varchar	""	Moneda "MXN", "USD"
cfdiPayments.tipocambiop *	decimal	"1"	Tipo de cambio
cfdiPayments.monto *	decimal	"0.0000"	Monto
cfdiPayments.numoperacion	varchar	""	Número de operación
cfdiPayments.ctaordenante	varchar	""	Cuenta bancaria del ordenante
cfdiPayments.rfcemisorctaben	varchar	""	RFC del emisor cuenta
cfdiPayments.ctabeneficiario	varchar	""	Cuenta bancaria del beneficiario
cfdiPayments.tipocadpago	varchar	""	Tipo de cadena de pago
cfdiPayments.certpago	text	""	Certificado de pago
cfdiPayments.cadpago	text	""	Cadena original del pago
cfdiPayments.sellopago	text	""	Sello digital
cfdiPayments.relateddocs.iddocumento *	text	""	UUID del documento relacionado
cfdiPayments.relateddocs.folio *	text	""	Folio del comprobante
cfdiPayments.relateddocs.serie *	text	""	Serie del comprobante
cfdiPayments.relateddocs.monedadr *	text	""	Moneda
cfdiPayments.relateddocs.tipocambiodr *	text	""	Tipo de cambio
cfdiPayments.relateddocs.metododepagodr *	text	""	Método de pago
cfdiPayments.relateddocs.numparcialidad *	int	0	Número de parcialidades
cfdiPayments.relateddocs.impsaldoant *	decimal	0.000	Importe de saldo anterior
cfdiPayments.relateddocs.impsaldopagado *	decimal	0.000	Importe de saldo pagado
cfdiPayments.relateddocs.impsaldoinsoluto *	decimal	0.000	Importe de saldo insoluto

Atención

1. Es obligatorio que la factura a relacionar tenga como método de pago "PPD".
2. Se requiere al menos dar de alta un pago para poder generar el comprobante correctamente.
3. Se requiere al menos dar de alta un documento relacionado al pago para poder generar el comprobante correctamente.

Ejemplo

Info

Envío de datos POST

{
    "accounting_effect": "P",
    "subsidiary_id": 48,
    "cfdi_regimenfiscal": "601",
    "currency_id": 2,
    "company_subsidiary_id":1,
    "cfdiPayments": [{
        "fechapago": "2019-01-01",
        "formadepagop": "01",
        "monedap": "MXN",
        "tipocambiop": 1,
        "relateddocs": [{
            "iddocumento": "F7F84A31-3F53-4776-AF38-137E28B7CFB5",
            "folio": "12",
            "serie": "a",
            "monedadr": "MXN",
            "tipocambiodr": 1,
            "metododepagodr": "PUE",
            "impsaldoant": "100.0000",
            "imppagado": "100.0000",
            "impsaldoinsoluto": "0.0000"
        }]
    }]
}

Creado de factura con RFC y Uso CFDI de un nuevo cliente

{
    "accounting_effect": "P",
    "sic_code": "SUL010720JN8",
    "cfdi_usocfdi": "P01",
    "cfdi_regimenfiscal": "601",
    "currency_id": 2,
    "company_subsidiary_id":1,
    "cfdiPayments": [{
        "fechapago": "2019-01-01",
        "formadepagop": "01",
        "monedap": "MXN",
        "tipocambiop": 1,
        "relateddocs": [{
            "iddocumento": "F7F84A31-3F53-4776-AF38-137E28B7CFB5",
            "folio": "12",
            "serie": "a",
            "monedadr": "MXN",
            "tipocambiodr": 1,
            "metododepagodr": "PUE",
            "impsaldoant": "100.0000",
            "imppagado": "100.0000",
            "impsaldoinsoluto": "0.0000"
        }]
    }]
}

Si la transacción se ejecuta correctamente, debe regresar el objeto creado como se muestra en el siguiente JSON:

{
  "accounting_effect": "P",
  "subsidiary_id": 43,
  "currency_id": 0,
  "exchange_rate": 0,
  "items": 0,
  "pieces": "0.000000",
  "subtotal": 0,
  "discount": 0,
  "subtotal_discount": "0.0000",
  "withheld_taxes_total": "0.0000",
  "transferred_taxes_total": "0.0000",
  "total": 0,
  "days_to_pay": 0,
  "receivable": 1,
  "deposited": 0,
  "canceled": 0,
  "tips": "0.0000",
  "active": 1,
  "company_subsidiary_id": 1,
  "payment_options": "01",
  "payment_method": "PPD",
  "folio": 0,
  "serial_number": "",
  "emitted": "2019-09-11T13:45:42",
  "terms_conditions": "",
  "carrier": "",
  "shipping": "",
  "notes": "",
  "received": "2019-09-11",
  "id": 449
}

Si se quiere ver todos los objetos relacionados al comprobante. Se necesita hacer la solicitud de la siguiente manera:

POST https://api.avanto.mx/v1/sales?expand=soldItems,cfdiPayments

{
  "accounting_effect": "P",
  "subsidiary_id": 43,
  "currency_id": 0,
  "exchange_rate": 0,
  "items": 0,
  "pieces": "0.000000",
  "subtotal": 0,
  "discount": 0,
  "subtotal_discount": "0.0000",
  "withheld_taxes_total": "0.0000",
  "transferred_taxes_total": "0.0000",
  "total": 0,
  "days_to_pay": 0,
  "receivable": 1,
  "deposited": 0,
  "canceled": 0,
  "tips": "0.0000",
  "active": 1,
  "company_subsidiary_id": 1,
  "payment_options": "01",
  "payment_method": "PPD",
  "folio": 0,
  "serial_number": "",
  "emitted": "2019-09-11T14:04:48",
  "terms_conditions": "",
  "carrier": "",
  "shipping": "",
  "notes": "",
  "received": "2019-09-11",
  "id": 450,
  "soldItems": [
    {
      "quantity": "1.000000",
      "unit_of_measure": "",
      "code": "",
      "description": "Pago",
      "unit_price": "0.0000",
      "amount": "0.0000",
      "discount": "0.0000",
      "non_taxable": 0,
      "cfdi_claveprodserv": "84111506",
      "cfdi_claveunidad": "ACT",
      "cfdi_cuentapredial": "",
      "notes": "",
      "created_at": "2019-09-11 14:04:48",
    }
  ],
  "cfdiPayments": [
    {
      "fechapago": "2019-01-01 00:00:00",
      "formadepagop": "01",
      "monedap": "MXN",
      "tipocambiop": "1.000000",
      "monto": "100.000000",
      "numoperacion": "",
      "rfcemisorctaord": "",
      "nombancoordext": "",
      "ctaordenante": "",
      "rfcemisorctaben": "",
      "ctabeneficiario": "",
      "tipocadpago": "",
      "certpago": "",
      "cadpago": "",
      "sellopago": "",
      "active": 1,
      "created_at": "2019-09-11 14:04:48",
      "relateddocs": [
        {
          "iddocumento": "F7F84A31-3F53-4776-AF38-137E28B7CFB5",
          "serie": "a",
          "folio": "12",
          "monedadr": "MXN",
          "tipocambiodr": "1.000000",
          "metododepagodr": "PUE",
          "numparcialidad": 1,
          "impsaldoant": "100.000000",
          "imppagado": "100.000000",
          "impsaldoinsoluto": "0.000000",
          "active": 1,
          "created_at": "2019-09-11 14:04:48"
        }
      ]
    }
  ]
}

Ejemplo sin precargar Cliente

{
    "accounting_effect": "P",
    "sic_code": "SUL010720JN8",
    "cfdi_usocfdi": "P01",
    "cfdi_regimenfiscal": "601",
    "currency_id": 2,
    "company_subsidiary_id":1,
    "cfdiPayments": [{
        "fechapago": "2019-01-01",
        "formadepagop": "01",
        "monedap": "MXN",
        "tipocambiop": 1,
        "relateddocs": [{
            "iddocumento": "F7F84A31-3F53-4776-AF38-137E28B7CFB5",
            "folio": "12",
            "serie": "a",
            "monedadr": "MXN",
            "tipocambiodr": 1,
            "metododepagodr": "PUE",
            "impsaldoant": "100.0000",
            "imppagado": "100.0000",
            "impsaldoinsoluto": "0.0000"
        }]
    }]
}