# Referencia de Mirakl

Configuración predeterminada para los eventos del plugin Miraki.

## Trabajos programados

### Onboarding

```bash
php bin/console connector:sync:onboarding -q 2>&1
```

- Configuración predeterminada: cada minuto.
- Configuración recomendada: todo lo posible.
- Descripción: recupera las tiendas de Mirakl creadas recientemente y añade el enlace de onboarding a su back office de Mirakl.
- Documentación: [Flujo de trabajo de onboarding](https://docs.stripe.com/use-stripe-apps/mirakl/onboarding-sellers.md).

### Validación de pagos

```bash
php bin/console connector:validate:pending-debit -q 2>&1
```

- Configuración predeterminada: cada 5 minutos.
- Configuración recomendada: < 1 hora.
- Descripción: recupera los pedidos de Mirakl aceptados recientemente, valida el pago en Mirakl y lo captura en Stripe.
- Documentación: [Flujo de trabajo de validación de pagos](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-validation).

### Desglose de pagos

```bash
php bin/console connector:dispatch:process-transfer -q 2>&1
```

- Configuración predeterminada: cada 5 minutos.
- Configuración recomendada: < 1 hora.
- Descripción: recupera los pedidos de Mirakl adeudados recientemente y crea transferencias de Stripe del operador al vendedor.
- Documentación: [Flujo de trabajo de fraccionamiento de pagos](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-split).

### Reembolso de pagos

```bash
php bin/console connector:dispatch:process-refund -q 2>&1
```

- Configuración predeterminada: cada 5 minutos.
- Configuración recomendada: < 1 hora.
- Descripción: recupera los reembolsos pendientes de Mirakl, crea el reembolso en Stripe, lo valida en Mirakl y anula la transferencia inicial.
- Documentación: [Flujo de trabajo de reembolso de pagos](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#payment-refund).

### Transferencia

```bash
php bin/console connector:dispatch:process-payout -q 2>&1
```

- Configuración predeterminada: cada día a las 13:00 h.
- Configuración recomendada: sincronizado con tus ciclos de facturación de Mirakl.
- Descripción: recuperar las *facturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) de Mirakl greadas recientemente y crear los envíos de fondos y *transferencias* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) de Stripe.
- Documentación: [flujo de trabajo de Payouts](https://docs.stripe.com/use-stripe-apps/mirakl/payments.md#pay-out-sellers).

### Alertas

```bash
php bin/console connector:notify:failed-operation -q 2>&1
```

- Configuración predeterminada: cada día a las 8:00 h.
- Configuración recomendada: según tus preferencias.
- Descripción: si está [habilitado](https://docs.stripe.com/use-stripe-apps/mirakl/configuration.md#alerting), envía un correo electrónico con todas las transferencias, reembolsos y envíos de dinero que han fallado.

## Notificación

Si está [habilitado](https://docs.stripe.com/use-stripe-apps/mirakl/configuration.md#alerting), el conector envía notificaciones de servidor a servidor en los siguientes eventos.

> Si tu punto de conexión es inaccesible o devuelve un error, se enviar un correo electrónico a tu `TECHNICAL_ALERT_EMAIL`.

### Cuenta actualizada

Una cuenta conectada de Stripe fue actualizada por el vendedor o por Stripe.

```json
{
  "type": "account.updated",
  "payload": {
    "miraklShopId": 2000,
    "stripeUserId": "acct_1032D82eZvKYlo2C"
  }
}
```

### Envío de fondos fallido

Se ha producido un error con un envío de fondos durante el [trabajo de desglose de pagos](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payment-split) o el [trabajo de transferencia](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payout).

```json
{
  "type": "transfer.failed",
  "payload": {
    "internalId": 5,
    "miraklId": 123,
    "type": "TRANSFER_ORDER",
    "stripeAccountId": "acct_1032D82eZvKYlo2C",
    "miraklShopId": 2003,
    "transferId": null,
    "transactionId": null,
    "amount": 3400,
    "status": "TRANSFER_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}
```

### Error en reembolso

Se ha producido un error al hacer un reembolso durante el [trabajo de reembolso de pagos](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payment-refund).

```json
{
  "type": "refund.failed",
  "payload": {
    "internalId": 5,
    "miraklOrderId": "order_refunded_5",
    "miraklRefundId": "1100",
    "stripeRefundId": null,
    "stripeReversalId": "trr_10",
    "amount": 3400,
    "status": "REFUND_FAILED",
    "failedReason": "Reason message",
    "currency": "EUR"
  }
}
```

### Transferencia fallida

Se ha producido un error en una transferencia durante el [trabajo de transferencias](https://docs.stripe.com/use-stripe-apps/mirakl/reference.md#payout).

```json
{
  "type": "payout.failed",
  "payload": {
    "internalId": 12,
    "amount": 2300,
    "currency": "EUR",
    "miraklInvoiceId": 2000,
    "stripePayoutId": null,
    "status": "PAYOUT_FAILED",
    "failedReason": "Reason message",
  }
}
```