API Tienda Capta

curl "https://marketplace.capta.best/api/tienda-externa/plazos" \
  -H "X-Api-Key: $CAPTA_API_KEY"

{ "data": [8, 10, 12, 14, 18] }

curl "https://marketplace.capta.best/api/tienda-externa/disponible?celular=6670000001&tipo=cliente" \
  -H "X-Api-Key: $CAPTA_API_KEY"

{
  "data": {
    "tipo": "cliente",
    "clienteId": 800001,
    "nombre": "MARIA PRUEBA LOPEZ",
    "enlaceId": 9001,
    "enlaceNombre": "ANA ENLACE PRUEBA",
    "puedeRecibirPedidos": true,
    "disponible": 15000.00,
    "disponibleCliente": 15000.00,
    "disponibleEnlace": 50000.00
  }
}

curl -X POST "https://marketplace.capta.best/api/tienda-externa/cotizar" \
  -H "X-Api-Key: $CAPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tipo": "cliente",
    "celular": "667 000 0001",
    "productos": [
      { "sku": "TV-55",  "nombre": "Pantalla 55\"",    "precio": 8999.00, "imagenUrl": "https://ejemplo.com/tv.jpg", "cantidad": 1, "plazo": 18 },
      { "sku": "SOP-01", "nombre": "Soporte de pared", "precio": 499.00,  "imagenUrl": null,                         "cantidad": 1, "plazo": 12 }
    ],
    "flete": 250.00,
    "transportista": "ESTAFETA"
  }'

{
  "data": {
    "subtotal": 9498.00,
    "flete": 250.00,
    "intereses": 8379.74,
    "total": 18127.74,
    "pagoQuincenal": 1036.58,
    "disponibleCliente": 15000.00,
    "disponibleEnlace": 50000.00,
    "cabeEnCredito": true,
    "vales": [
      { "plazo": 12, "subtotal": 499.00,  "flete": 125.00, "capital": 624.00,  "intereses": 437.40,  "total": 1061.40,  "pagoQuincenal": 88.45 },
      { "plazo": 18, "subtotal": 8999.00, "flete": 125.00, "capital": 9124.00, "intereses": 7942.34, "total": 17066.34, "pagoQuincenal": 948.13 }
    ]
  }
}

curl -X POST "https://marketplace.capta.best/api/tienda-externa/pedidos" \
  -H "X-Api-Key: $CAPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externoId": "A-100234",
    "tipo": "cliente",
    "celular": "6670000001",
    "productos": [
      { "sku": "TV-55",  "nombre": "Pantalla 55\"",    "precio": 8999.00, "imagenUrl": "https://ejemplo.com/tv.jpg", "cantidad": 1, "plazo": 18 },
      { "sku": "SOP-01", "nombre": "Soporte de pared", "precio": 499.00,  "imagenUrl": null,                         "cantidad": 1, "plazo": 12 }
    ],
    "flete": 250.00,
    "transportista": "ESTAFETA",
    "entrega": {
      "calle": "Av. Obregón", "numeroExterior": "850", "numeroInterior": null, "colonia": "Centro",
      "codigoPostal": "80000", "municipio": "Culiacán", "estado": "Sinaloa", "referencias": "Portón negro"
    },
    "notas": "Entregar por la tarde"
  }'

curl "https://marketplace.capta.best/api/tienda-externa/pedidos?estatus=autorizado&firmado=true" \
  -H "X-Api-Key: $CAPTA_API_KEY"

{
  "data": {
    "total": 1,
    "pagina": 1,
    "porPagina": 50,
    "pedidos": [
      {
        "externoId": "A-100234",
        "pedidoId": 900001,
        "fechaRegistro": "2026-11-11T10:15:00.123",
        "tipo": "cliente",
        "estatus": "autorizado",
        "firmado": true,
        "comprador": { "nombre": "MARIA PRUEBA LOPEZ", "celular": "6670000001" },
        "enlaceNombre": "ANA ENLACE PRUEBA",
        "entrega": { "calle": "Av. Obregón", "numeroExterior": "850", "numeroInterior": null, "colonia": "Centro", "codigoPostal": "80000", "municipio": "Culiacán", "estado": "Sinaloa", "referencias": "Portón negro" },
        "total": 17264.52,
        "pagoQuincenal": 987.22,
        "folios": ["F900001", "F900002"],
        "fechaEnvio": null,
        "notasEnvio": null
      }
    ]
  }
}

curl "https://marketplace.capta.best/api/tienda-externa/pedidos/A-100234" \
  -H "X-Api-Key: $CAPTA_API_KEY"

{
  "data": {
    "externoId": "A-100234",
    "pedidoId": 900001,
    "estatus": "autorizado",
    "tipo": "cliente",
    "clienteId": 800001,
    "enlaceId": 9001,
    "comprador": { "nombre": "MARIA PRUEBA LOPEZ", "celular": "6670000001" },
    "enlaceNombre": "ANA ENLACE PRUEBA",
    "entrega": { "calle": "Av. Obregón", "numeroExterior": "850", "numeroInterior": null, "colonia": "Centro", "codigoPostal": "80000", "municipio": "Culiacán", "estado": "Sinaloa", "referencias": "Portón negro" },
    "notas": "Entregar por la tarde",
    "transportista": "ESTAFETA",
    "subtotal": 9498.00,
    "flete": 250.00,
    "intereses": 7516.52,
    "total": 17264.52,
    "pagoQuincenal": 987.22,
    "planElegido": true,
    "firmado": false,
    "fechaRegistro": "2026-11-11T10:15:00.123",
    "fechaAutorizacion": "2026-11-11T11:02:41.507",
    "fechaEnvio": null,
    "notasEnvio": null,
    "fechaCancelacion": null,
    "motivoCancelacion": null,
    "vales": [
      { "folio": "F900001", "plazo": 12, "subtotal": 499.00,  "flete": 125.00, "total": 1010.88,  "pagoQuincenal": 84.24,  "firmado": true,  "estatus": "activo", "skus": ["SOP-01"] },
      { "folio": "F900002", "plazo": 18, "subtotal": 8999.00, "flete": 125.00, "total": 16253.64, "pagoQuincenal": 902.98, "firmado": false, "estatus": "activo", "skus": ["TV-55"] }
    ]
  }
}

curl -X POST "https://marketplace.capta.best/api/tienda-externa/pedidos/A-100234/enviado" \
  -H "X-Api-Key: $CAPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "notasEnvio": "ESTAFETA guía 1234567890, sale hoy" }'

curl -X POST "https://marketplace.capta.best/api/tienda-externa/pedidos/A-100234/cancelar" \
  -H "X-Api-Key: $CAPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "motivo": "Sin existencia" }'

POST {su URL}
Content-Type: application/json
X-Capta-Evento: pedido.autorizado
X-Capta-Evento-Id: 5821
X-Capta-Timestamp: 1794412345
X-Capta-Firma: sha256=3f1c…e9

{ "evento": "pedido.autorizado", "valeFolio": null, "pedido": { …mismo objeto que GET /pedidos/{externoId}… } }

const crypto = require('crypto');

app.post('/webhooks/capta', express.raw({ type: 'application/json' }), (req, res) => {
  const timestamp = req.get('X-Capta-Timestamp');
  const firma = req.get('X-Capta-Firma') || '';
  const esperada = 'sha256=' + crypto
    .createHmac('sha256', process.env.CAPTA_WEBHOOK_SECRET)
    .update(`${timestamp}.${req.body.toString('utf8')}`)
    .digest('hex');

  const valida = firma.length === esperada.length
    && crypto.timingSafeEqual(Buffer.from(firma), Buffer.from(esperada));
  const reciente = Math.abs(Date.now() / 1000 - Number(timestamp)) <= 300;
  if (!valida || !reciente) return res.sendStatus(401);

  const { evento, valeFolio, pedido } = JSON.parse(req.body.toString('utf8'));
  // guardar / encolar y responder rápido
  res.sendStatus(200);
});

static bool FirmaValida(string secreto, string timestamp, string cuerpo, string firma)
{
    var hash = HMACSHA256.HashData(Encoding.UTF8.GetBytes(secreto), Encoding.UTF8.GetBytes($"{timestamp}.{cuerpo}"));
    var esperada = "sha256=" + Convert.ToHexString(hash).ToLowerInvariant();
    return CryptographicOperations.FixedTimeEquals(Encoding.ASCII.GetBytes(esperada), Encoding.ASCII.GetBytes(firma ?? ""))
        && Math.Abs(DateTimeOffset.UtcNow.ToUnixTimeSeconds() - long.Parse(timestamp)) <= 300;
}

H="X-Api-Key: $CAPTA_API_KEY"
curl -X POST https://marketplace.capta.best/sandbox/pedidos/A-100234/autorizar -H "$H" -H "Content-Type: application/json" -d '{ "porcentaje": 16 }'
curl -X POST https://marketplace.capta.best/sandbox/pedidos/A-100234/firmar -H "$H"
curl -X POST https://marketplace.capta.best/sandbox/pedidos/A-100234/firmar -H "$H"
curl -X POST https://marketplace.capta.best/api/tienda-externa/pedidos/A-100234/enviado \
  -H "$H" -H "Content-Type: application/json" -d '{ "notasEnvio": "ESTAFETA 123" }'
curl -X POST https://marketplace.capta.best/sandbox/pedidos/A-100234/pagar -H "$H"