POST
/cards/v1/batches/bulkCrear Múltiples Lotes de Innominadas
El endpoint /cards/v1/batches/bulk te permite crear hasta 15 lotes de tarjetas innominadas al mismo tiempo.
Validaremos que cumplas los requisitos que detallamos en la documentación.
Consideraciones
- Cada lote tiene un máximo de 1.000 tarjetas.
- La dirección de envío es obligatoria si el tipo de distribución es
CLIENT. - Procesaremos la llamada de forma asincrónica, es decir que es posible que las tarjetas no estén disponibles inmediatamente.
Parámetros disponibles
Header Parameters
AuthorizationStringrequired
x-idempotency-keyStringrequired
Cuerpo de solicitud
application/jsonaffinity_group_idstringrequired
quantitynumberrequired
distribution_typeenumrequired
addressobject10 propiedades
receiverobject5 propiedades
Detalle de respuestas
401
No autorizado
403
Acceso denegado
Ejemplo de solicitud
{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"quantity": 100,
"distribution_type": "CLIENT",
"address": {
"street_name": "Street",
"street_number": "123",
"floor": "5",
"apartment": "A",
"city": "Buenos Aires",
"region": "Buenos Aires",
"country": "Argentina",
"zip_code": "5653",
"neighborhood": "Palermo",
"additional_info": "Torre 2. Casa amarilla"
},
"receiver": {
"full_name": "Gonzalo Iglesias",
"email": "[email protected]",
"document_type": "DNI",
"document_number": "35354896",
"telephone_number": "1132421452"
}
}Ejemplo de código
curl -X POST "https://api.pomelo.la/cards/v1/batches/bulk" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "x-idempotency-key: fRwX12Dg3345AD" \
-d '{
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"quantity": 100,
"distribution_type": "CLIENT",
"address": {
"street_name": "Street",
"street_number": "123",
"floor": "5",
"apartment": "A",
"city": "Buenos Aires",
"region": "Buenos Aires",
"country": "Argentina",
"zip_code": "5653",
"neighborhood": "Palermo",
"additional_info": "Torre 2. Casa amarilla"
},
"receiver": {
"full_name": "Gonzalo Iglesias",
"email": "[email protected]",
"document_type": "DNI",
"document_number": "35354896",
"telephone_number": "1132421452"
}
}'Ejemplo de respuesta (202)Batches de tarjetas aceptados
{
"data": {
"shipment_ids": [
"shi-2VOLbX1fAeWAn1rABlorxBqRyGF",
"shi-2VOuvlG4bi0BVgXyCqDHY4ByTD5"
],
"affinity_group_id": "afg-20MpN8vmIPj77ujhb9cS8ctstN2",
"card_type": "PHYSICAL",
"quantity": 100,
"distribution_type": "CLIENT"
}
}