Recordar en todos los casos enviar como param el appId y dentro de los headers como Authorization, el appKey.
Todos los envíos
Curl de ejemplo:
curl --location 'https://api-dev.moova.io/saas/shippings?appId=appId' \
--header 'accept: */*' \
--header 'X-CSRF-TOKEN;' \
--header 'Authorization: Authorization'
Respuesta Exitosa:
{
"data":[
{
"id":"71f01930-6c79-11e9-ae36-1f10b96d0a00",
"shortId":"71f01930",
"companyId":2,
"courierCompanyId":null,
"packagesCount":1,
"scheduledDate":"2019-05-07 07:00:00",
"deliveryTimeRange":null,
"type":"regular",
"size":"M",
"priceFormatted":"$ 100,00",
"price":"100.00",
"currency":"ARS",
"from":{
"placeId":11,
"googlePlaceId":"ChIJ2bnO6YLKvJURZLg0__aAwys",
"address":"Billinghurst 2162, C1425DTR CABA, Argentina",
"addressExtra":"3, F",
"contact":"ERS",
"email":"[email protected]",
"phone":" ",
"instructions":null,
"coords":{
"lat":-34.5865505,
"lng":-58.4071932
}
},
"to":{
"placeId":6,
"googlePlaceId":"EiRCZXJ1dGkgMzQ0NCwgQnVlbm9zIEFpcmVzLCBBcmdlbnRpbmEiMRIvChQKEgnvWBsHgsq8lRH0-tkG_5FmHhD0GioUChIJ5VL2PYPKvJURyC2dtKLRN-k",
"address":"Beruti 3444, C1425BBT CABA, Argentina",
"addressExtra":"Piso 7",
"contact":"José Fernandez",
"email":"[email protected]",
"phone":" ",
"instructions":"---\nHorario: \nLunes, Martes, Miércoles, Jueves, Viernes\n\t- De 09:00 a 18:00\n\n---\n\n---\nHorario: \nLunes, Martes, Miércoles, Jueves, Viernes\n\t- De 09:00 a 18:00\n\n---\n",
"coords":{
"lat":-34.5863154,
"lng":-58.4111762
}
},
"status":"READY",
"secretCode":"uSX1k",
"internalCode":"internal_code_45",
"internalOrderId":null,
"internalExtraId":null,
"description":null,
"hash":"892e9c142ca783f35e211a30487105dd381859b141882983142a255ed8cfca90",
"message":"Feliz cumpleños",
"extra":{
"foo":"bar"
},
"conf":null,
"deliveryInfo":{
"courier":"Moises",
"lat":null,
"lng":null,
"receiver":{
"firstName":"José Fernandez",
"lastName":"",
"scannedInfo":null
}
},
"statusHistory":null,
"activeSettings":[
],
"services":[
],
"relatedShippings":{
"previous":null,
"next":null
},
"items":[
],
"createdAt":"2019-05-02 01:27:26",
"addressErrors":null
},
{
"id":"71f7f8d0-6c79-11e9-a733-89ca1935685d",
"shortId":"71f7f8d0",
"companyId":2,
"courierCompanyId":null,
"packagesCount":1,
"scheduledDate":"2019-05-07 07:00:00",
"deliveryTimeRange":null,
"type":"regular",
"size":"M",
"priceFormatted":"$ 102,92",
"price":"102.92",
"currency":"ARS",
"from":{
"placeId":37,
"googlePlaceId":"ChIJqSJcUye0vJUR_XO3GmrtKTA",
"address":"Av. Crisólogo Larralde 1809, C1429BSI CABA, Argentina",
"addressExtra":"S/N",
"contact":"ERS",
"email":"[email protected]",
"phone":null,
"instructions":null,
"coords":{
"lat":-34.5460166,
"lng":-58.4626179
}
},
"to":{
"placeId":48,
"googlePlaceId":"ChIJ3xxRUNI0o5URuhK-sIhjvWE",
"address":"Av. Paseo Colón 1200, Buenos Aires, Argentina",
"addressExtra":"8B",
"contact":"José Fernandez",
"email":"[email protected]",
"phone":null,
"instructions":null,
"coords":{
"lat":-34.6216072,
"lng":-58.3682582
}
},
"status":"READY",
"secretCode":"AtUTm",
"internalCode":"internal_code_46",
"internalOrderId":null,
"internalExtraId":null,
"description":null,
"hash":"010fdf89acb648265cb1fae7fef7e5a968f71269de8e66ad407cc441a87eb3ec",
"message":"Feliz cumpleños",
"extra":{
"foo":"bar"
},
"conf":null,
"deliveryInfo":{
"courier":"Moises",
"lat":null,
"lng":null,
"receiver":{
"firstName":"",
"lastName":"",
"scannedInfo":null
}
},
"statusHistory":null,
"activeSettings":[
],
"services":[
],
"relatedShippings":{
"previous":null,
"next":null
},
"items":[
],
"createdAt":"2019-05-02 01:27:27",
"addressErrors":null
}
],
"pagination":{
"total":2,
"limit":500,
"page":0
}
}
Creación
Curl de ejemplo:
curl -X 'POST' \
'https://api-dev.moova.io/saas/shippings?appId=appId' \
-H 'accept: */*' \
-H 'Authorization: Authorization' \
-H 'Content-Type: application/json' \
-H 'X-CSRF-TOKEN: ' \
-d '{
"type":"regular",
"flow":"manual",
"internalOrderId":"pedido123",
"from":{
"address":"Av. Santa Fe 1234, 1425 CABA, Buenos Aires, Argentina",
"postalCode":"1425",
"contact":{
"name":"Juan",
"phone":"+541112345678",
"email":"[email protected]"
}
},
"to":{
"street":"Av. Corrientes",
"number":300,
"city":"CABA",
"state":"Buenos Aires",
"postalCode":"1199",
"country":"AR",
"contact":{
"firstName":"Maria",
"lastName":"Gonzalez",
"phone":"+541199876543",
"email":"[email protected]"
},
"instructions":"Entregar en conserjería"
},
"items":[
{
"type":"box",
"description":"RELOJ PARA HOMBRE",
"referenceCode":"88667859432832",
"quantity":1,
"weight":1500,
"length":30,
"width":20,
"height":15
}
]
}'
Respuesta Exitosa:
{
"id": "a1a5eee0-955b-11f0-9498-81d03bed2fed",
"shortId": "a1a5eee0",
"companyId": 1,
"courierCompanyId": null,
"packagesCount": 1,
"scheduledDate": null,
"deliveryTimeRange": null,
"type": "regular",
"size": "M",
"priceFormatted": "$ 220.000,02",
"price": 220000.02,
"currency": "ARS",
"from": {
"placeId": 97425,
"googlePlaceId": "ChIJfzoxtbnKvJUR2O-zSUSNVlY",
"address": "Av. Sta. Fe 1234, C1059ABT Cdad. Autónoma de Buenos Aires, Argentina",
"addressExtra": null,
"contact": "Marcos Detry",
"email": "[email protected]",
"phone": "+541112345678",
"instructions": null,
"coords": {
"lat": -34.5959117,
"lng": -58.3846907
}
},
"to": {
"placeId": 98971,
"googlePlaceId": "ChIJY8jbyTI1o5URmVJmCu1e1TQ",
"address": "Av. Corrientes 300, C1043AAR Cdad. Autónoma de Buenos Aires, Argentina",
"addressExtra": null,
"contact": "Maria Gonzalez",
"email": "[email protected]",
"phone": "+541199876543",
"instructions": "Entregar en conserjería",
"coords": {
"lat": -34.6031762,
"lng": -58.3712136
}
},
"status": "DRAFT",
"secretCode": "5925",
"internalCode": null,
"internalOrderId": "pedido123",
"internalExtraId": null,
"description": null,
"hash": "091082f53de9fcb1d386c4da88bf5c1e3d21658f4ffc88d3416c303c9eba4475",
"message": null,
"extra": null,
"conf": null,
"deliveryInfo": {
"courier": null,
"lat": null,
"lng": null,
"receiver": {
"firstName": null,
"lastName": null,
"scannedInfo": null
}
},
"statusHistory": [
{
"status": "DRAFT",
"details": null,
"createdAt": "2025-09-19 13:22:03"
}
],
"activeSettings": [
{
"id": 3,
"name": "SignaturePhoto",
"apply_to_all": 1,
"description": "Instead of ask for a signature, take a picture of the package.",
"message": "Debido al coronavirus, en vez de solicitar la firma, por favor sacale una foto a la puerta del domicilio donde estás haciendo la entrega.",
"created_at": "2021-01-05 19:01:27",
"updated_at": "2021-01-05 19:01:27",
"deleted_at": null,
"laravel_through_key": "a1a5eee0-955b-11f0-9498-81d03bed2fed"
},
{
"id": 4,
"name": "DeliveryUserIdentification",
"apply_to_all": 1,
"description": "Request user identification when shipping is delivered",
"message": "Documento de identidad",
"created_at": "2021-01-05 19:01:27",
"updated_at": "2021-01-05 19:01:27",
"deleted_at": null,
"laravel_through_key": "a1a5eee0-955b-11f0-9498-81d03bed2fed"
}
],
"services": [],
"relatedShippings": {
"previous": null,
"next": null
},
"items": [
{
"description": "RELOJ PARA HOMBRE",
"referenceCode": "88667859432832",
"serialNumber": null,
"weight": 1500,
"length": 30,
"width": 20,
"height": 15,
"quantity": 1,
"meta": null
}
],
"createdAt": "2025-09-19 13:22:03",
"addressErrors": null
}
Buscar información
Curl de ejemplo:
curl -X 'GET' \ 'https://api-dev.moova.io/saas/shippings/a1a5eee0-955b-11f0-9498-81d03bed2fed?appId=appId' \ -H 'accept: application/json' \ -H 'Authorization: Authorization' \ -H 'X-CSRF-TOKEN: '
Actualiza
Curl de ejemplo:
curl --location --request PUT 'https://api-dev.moova.io/saas/shippings/f8e868d0-adec-11f0-8b89-ad2ed13eeb66?appId=appId' \
--header 'accept: */*' \
--header 'Authorization: Authorization' \
--header 'Content-Type: application/json' \
--header 'X-CSRF-TOKEN;' \
--data-raw '{
"to":{
"street":"Av. Corrientes",
"number":500,
"city":"CABA",
"state":"Buenos Aires",
"postalCode":"1199",
"country":"AR",
"contact":{
"firstName":"Maria",
"lastName":"Gonzalez",
"phone":"+541199876543",
"email":"[email protected]"
},
"instructions":"Entregar en conserjería"
}
}'
Respuesta Exitosa:
{
"id": "f8e868d0-adec-11f0-8b89-ad2ed13eeb66",
"shortId": "f8e868d0",
"companyId": 1,
"courierCompanyId": null,
"packagesCount": 1,
"scheduledDate": null,
"deliveryTimeRange": null,
"type": "regular",
"size": "M",
"priceFormatted": "$ 220.000,02",
"price": "220000.02",
"currency": "ARS",
"from": {
"placeId": 97425,
"googlePlaceId": "ChIJfzoxtbnKvJUR2O-zSUSNVlY",
"address": "Av. Sta. Fe 1234, C1059ABT Cdad. Autónoma de Buenos Aires, Argentina",
"addressExtra": null,
"contact": "Marcos Detry",
"email": "[email protected]",
"phone": "+541112345678",
"instructions": null,
"coords": {
"lat": -34.5959117,
"lng": -58.3846907
}
},
"to": {
"placeId": 99511,
"googlePlaceId": "ChIJV8VAEM3KvJUREswDmQpDXxI",
"address": "Av. Corrientes 500, C1043 San Nicolas, Cdad. Autónoma de Buenos Aires, Argentina",
"addressExtra": null,
"contact": "Maria Gonzalez",
"email": "[email protected]",
"phone": "+541199876543",
"instructions": "Entregar en conserjería",
"coords": {
"lat": -34.6034408,
"lng": -58.3737095
}
},
"lastKnownLocation": {
"placeId": 97425,
"googlePlaceId": "ChIJfzoxtbnKvJUR2O-zSUSNVlY",
"address": "Av. Sta. Fe 1234, C1059ABT Cdad. Autónoma de Buenos Aires, Argentina",
"contact": "Marcos Detry",
"email": "[email protected]",
"phone": "+541112345678",
"instructions": null,
"coords": {
"lat": -34.5959117,
"lng": -58.3846907
},
"warehouse": null
},
"status": "READY",
"secretCode": "3218",
"internalCode": null,
"internalOrderId": null,
"internalExtraId": null,
"description": "Kit promocional",
"hash": "751d635277e041d888517a7809cf3cb7140e2d6f3e8a517f9b60064e4680c515",
"message": null,
"extra": [],
"conf": null,
"deliveryInfo": {
"courier": null,
"lat": null,
"lng": null,
"receiver": {
"firstName": "",
"lastName": "",
"scannedInfo": null
}
},
"statusHistory": [
{
"status": "READY",
"details": null,
"createdAt": "2025-10-20 19:42:54"
}
],
"activeSettings": [
{
"id": 3,
"name": "SignaturePhoto",
"apply_to_all": 1,
"description": "Instead of ask for a signature, take a picture of the package.",
"message": "Debido al coronavirus, en vez de solicitar la firma, por favor sacale una foto a la puerta del domicilio donde estás haciendo la entrega.",
"created_at": "2021-01-05 19:01:27",
"updated_at": "2021-01-05 19:01:27",
"deleted_at": null,
"laravel_through_key": "f8e868d0-adec-11f0-8b89-ad2ed13eeb66"
},
{
"id": 4,
"name": "DeliveryUserIdentification",
"apply_to_all": 1,
"description": "Request user identification when shipping is delivered",
"message": "Documento de identidad",
"created_at": "2021-01-05 19:01:27",
"updated_at": "2021-01-05 19:01:27",
"deleted_at": null,
"laravel_through_key": "f8e868d0-adec-11f0-8b89-ad2ed13eeb66"
}
],
"services": [],
"relatedShippings": {
"previous": null,
"next": null
},
"items": [
{
"description": "RELOJ PARA HOMBRE",
"referenceCode": "88667859432832",
"serialNumber": null,
"weight": 1500,
"length": 30,
"width": 20,
"height": 15,
"quantity": 1,
"meta": null
},
{
"description": "RELOJ PARA HOMBRE",
"referenceCode": "88667859432832",
"serialNumber": null,
"weight": 1500,
"length": 30,
"width": 20,
"height": 15,
"quantity": 1,
"meta": null
}
],
"createdAt": "2025-10-20 19:42:54",
"addressErrors": null
} Cambiar el Status
Curl de ejemplo:
curl -X 'POST' \
'https://api-dev.moova.io/saas/shippings/a1a5eee0-955b-11f0-9498-81d03bed2fed/READY?appId=appId' \
-H 'accept: */*' \
-H 'Authorization: Authorization' \
-H 'Content-Type: multipart/form-data' \
-H 'X-CSRF-TOKEN: ' \
Respuesta Exitosa:
{
"status": "READY",
"shipping_id": "a1a5eee0-955b-11f0-9498-81d03bed2fed",
"courier_id": null,
"user_id": null,
"applied_by_id": null,
"updated_at": "2025-09-19 13:32:39",
"created_at": "2025-09-19 13:32:39",
"id": 829252
}
Modificar las dimensiones
Curl de ejemplo:
curl -X 'PATCH' \
'https://api-dev.moova.io/saas/shippings/a1a5eee0-955b-11f0-9498-81d03bed2fed/items/overwrite?appId=appId' \
-H 'accept: */*' \
-H 'Authorization: Authorization' \
-H 'Content-Type: application/json' \
-H 'X-CSRF-TOKEN: ' \
-d '{
"weight": 20,
"length": 20,
"width": 20,
"height": 20
}'
Repuesta Exitosa:
200 OK
Obtener etiqueta
El format puede ser "url", "zpl" o "data" dependiendo de lo que se requiera.
Curl de ejemplo:
curl -X 'GET' \
'https://api-dev.moova.io/saas/shippings/a1a5eee0-955b-11f0-9498-81d03bed2fed/label?appId=appId&format=url' \
-H 'accept: */*' \
-H 'Authorization: Authorization' \
-H 'X-CSRF-TOKEN: '
Respuesta Exitosa:
{ "label":"https://s3.amazonaws.com/files.dev.moova.io/ecosystems/1/shippings/labels/a1a5eee0-955b-11f0-9498-81d03bed2fed_skus.pdf"
}
Obtener Foto
Curl de ejemplo:
curl -X 'GET' \
'https://api-dev.moova.io/saas/shippings/a1a5eee0-955b-11f0-9498-81d03bed2fed/photos?appId=appId' \
-H 'accept: */*' \
-H 'Authorization: Authorization' \
-H 'X-CSRF-TOKEN: '
Respuesta Exitosa:
{
"data": [
{
"id": 5957,
"shipping_id": "a1a5eee0-955b-11f0-9498-81d03bed2fed",
"comment": "",
"full_path": "https://s3.amazonaws.com/files.dev.moova.io/ecosystems/1/users/513/NoNfeeCrMYVAkaWlzAbtD898ND1NAzh6J3j64z6E.jpg",
"type": "PICKEDUP",
"main": 1,
"valid_percentage": "0.00",
"meta": null,
"source": null,
"shipping_status_id": null,
"applied_by_id": 513,
"content_status": null,
"created_at": "2025-09-19 13:49:12",
"updated_at": "2025-09-19 13:49:12",
"deleted_at": null
}
],
"pagination": {
"total": 1,
"limit": 500,
"page": 0
}
}
Obtener los Id dentro del Pickup
Curl de ejemplo:
curl -X 'GET' \ 'https://api-dev.moova.io/saas/shippings/72774ce0-840d-11f0-a82e-2508694cb5db/pickups?appId=appId' \ -H 'accept: */*' \ -H 'Authorization: Authorization' \ -H 'X-CSRF-TOKEN: '
Respuesta Exitosa:
{
"data": [
{
"id": "c8d9fad0-840c-11f0-b85e-47feeef81302"
},
{
"id": "d38a34d0-840c-11f0-8e57-07b73aed7ed5"
},
{
"id": "e4acd720-840c-11f0-9df6-f5e059d78c7f"
}
],
"pagination": {
"total": 3,
"limit": 500,
"page": 0
}
}
Chequear las condiciones para cambiar el status
Curl de ejemplo:
curl --location 'https://api-dev.moova.io/saas/shippings/7d20a280-7491-11f0-9827-5b8488b213f0/statuses/READY/check?appId=appId' \
--header 'accept: */*' \
--header 'X-CSRF-TOKEN;' \
--header 'Authorization: Authorization'
Respuesta Exitosa:
1