Sincronización de documentos

Qué cambió en este lado del espacio de trabajo, del más antiguo al más reciente. Un evento nombra un documento, nunca su contenido: lee el documento con la operación correspondiente, así siempre obtienes su versión actual. Devuelve nextCursor como after en tu siguiente llamada; mientras hasMore sea true, vuelve a llamar de inmediato. Los eventos se conservan 30 días y se entregan al menos una vez, así que el mismo cambio puede llegar dos veces; los 5 segundos más recientes esperan a la siguiente llamada. Un llamador proveedor recibe purchase_order.issued, changed, canceled y rejected; invoice.received, approved, rejected, paid, payment_withdrawn, remittance_sent y credit_applied; invoice.updated (un comprador puso la factura en espera para revisarla, o la liberó: lee GetInvoiceStatus); y credit_note.accepted y rejected. Un llamador comprador recibe invoice.received y credit_note.received (un proveedor envió uno); invoice.updated (una factura se aprobó, por una persona o automáticamente, o se rechazó, o su proveedor confirmó los datos bancarios o la reportó); invoice.payment (se registró o retiró un pago, un crédito saldó la factura, o un pago a través de Pleaxy se completó o falló: consulta GetInvoiceRemittance); purchase_order.updated (una orden se aprobó, se rechazó o se canceló); y purchase_order.confirmed y purchase_order.shipped (consulta GetPurchaseOrderFulfillment). Solo recibe los tipos de documento que su rol de compras puede ver.

Una orden de compra emitida como documento que tu sistema puede importar. format=cxml (el predeterminado) es un OrderRequest de cXML: tipo new, update a partir de la versión 2, delete una vez cancelada. format=ubl es un Order de UBL 2.1, o un OrderCancellation una vez cancelada. Ambas partes se identifican por sus IDs de espacio de trabajo. Es la copia del proveedor, pida quien la pida. Un proveedor cuyos compradores comparten un id de orden de compra agrega ?buyer=<buyer Workspace ID>.

Una factura como Invoice de UBL 2.1 (tipo 380, o 383 para una nota de débito), para que el ERP del comprador la contabilice o para el archivo del proveedor: sus líneas, descuentos y cargos a nivel de documento, impuestos y retenciones, anticipos, las instrucciones de pago del proveedor, y la orden de compra y el contrato que factura. Los totales cuadran con el importe de la factura. Es la vista del proveedor, pida quien la pida: sin conciliación, hallazgos ni aprobaciones.

En qué estado está una factura, para el sistema que la envió o el que la paga, como un estado con los códigos que usan para ello los sistemas de facturación electrónica. Lo mismo en cXML o UBL es GetInvoiceStatusDocument. Es la vista del proveedor, pida quien la pida.

GetInvoiceStatus como documento. format=cxml (el predeterminado) es un StatusUpdateRequest de cXML con un InvoiceStatus; format=ubl es un ApplicationResponse de UBL 2.1 con los códigos del Invoice Response de Peppol y, para un rechazo, su motivo.

La señal de pago de una factura, para la aplicación de cobros del proveedor: cómo y cuándo pagó el comprador, la referencia, qué se retuvo y qué llegó al proveedor, y los avisos de pago que envió el comprador (notas y comprobantes de pago; GetRemittanceFile descarga uno). Pleaxy registra lo que declara el comprador y no mueve dinero. Nunca quién lo registró del lado del comprador. Lo mismo en cXML o UBL es GetInvoiceRemittanceDocument.

GetInvoiceRemittance como documento. format=cxml (el predeterminado) es un PaymentRemittanceRequest de cXML; format=ubl es un RemittanceAdvice de UBL 2.1.

Registra pagos que tu ERP o tu conexión bancaria ya hicieron fuera de Pleaxy (transferencias, cheques, ACH, tarjeta), para que cada proveedor reciba su notificación de pago, su aviso de pago y su evento de sincronización sin que nadie lo vuelva a teclear. Esto no mueve dinero. Cada pago sigue las reglas de RecordPayment y se responde por separado; repetir uno es seguro (already_recorded). Una factura aprobada por una clave de API se sigue rechazando. note se convierte en una nota del aviso de pago para el proveedor; solo una persona puede adjuntar un comprobante de pago.

Solo clave de API de comprador con el ámbito payments:record, creada con un procurementRole que pueda editar facturas (administrator o finance). Una persona con sesión iniciada usa RecordPayment.