rentme-tasks

Ritorna il catalogo delle competenze (skill) disponibili su Rentme, con il loro id. Usa questo strumento PRIMA di rentme_create_task quando vuoi associare una competenza specifica al task, per sapere quale skill_id passare.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Pubblica una richiesta di operazione fisica nel mondo reale (sopralluogo, consegna, verifica, montaggio, ecc.) sulla bacheca Rentme, dove collaboratori umani registrati possono candidarsi per eseguirla dietro compenso. Usa questo strumento quando serve far compiere un'azione fisica reale da una persona. Se vuoi associare una competenza specifica, chiama prima rentme_list_skills per conoscere gli id disponibili.

{
  "type": "object",
  "properties": {
    "titolo": {
      "type": "string",
      "description": "Titolo breve del task"
    },
    "descrizione": {
      "type": "string",
      "description": "Descrizione dettagliata di cosa va fatto"
    },
    "compenso": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Compenso offerto, nella valuta indicata"
    },
    "valuta": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "default": "EUR",
      "description": "Codice valuta a 3 lettere, es. EUR"
    },
    "skill_id": {
      "type": "integer",
      "description": "ID della competenza richiesta, ottenuto da rentme_list_skills"
    },
    "luogo_testuale": {
      "type": "string",
      "description": "Luogo in cui va svolto il task"
    },
    "scadenza": {
      "type": "string",
      "description": "Scadenza, formato \"YYYY-MM-DD HH:MM:SS\""
    },
    "riferimento_ai": {
      "type": "string",
      "description": "Riferimento a piacere per ritrovare il task in seguito con rentme_check_task_status"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "URL https:// a cui Rentme invierà una notifica automatica quando lo stato del task cambia (es. quando viene completato)"
    },
    "posti_totali": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Quante persone possono essere assegnate a questo stesso task prima che sparisca dalla bacheca (default 1). Utile per richieste ripetibili, es. \"condividi un post\" valida per 100 persone."
    }
  },
  "required": [
    "titolo",
    "descrizione",
    "compenso"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Controlla lo stato di avanzamento di un task creato su Rentme (aperto, assegnato, in_corso, completato, annullato), cercandolo per id interno o per riferimento_ai fornito in fase di creazione.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "ID interno del task"
    },
    "riferimento_ai": {
      "type": "string",
      "description": "Riferimento esterno fornito alla creazione"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ritorna le categorie e sottocategorie degli oggetti a noleggio su Rentme (Things), con il loro id. Utile per filtrare rentme_search_things per categoria.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cerca su Rentme oggetti da noleggiare da persone reali della zona: attrezzi (trapani, idropulitrici, scale), giardinaggio, strumenti musicali, audio/video, bici, campeggio, feste, ecc. Consegna e ritiro a domicilio sono compresi nel prezzo. Indica SEMPRE indirizzo_consegna quando lo conosci: vengono restituiti solo gli oggetti che il proprietario può consegnare lì, ordinati per distanza. Prezzi in EUR a ora, giorno e/o mese.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Cosa si cerca, es. \"idropulitrice\", \"scala\", \"chitarra\""
    },
    "categoria_id": {
      "type": "integer",
      "description": "Id di categoria o sottocategoria, da rentme_list_thing_categories"
    },
    "indirizzo_consegna": {
      "type": "string",
      "description": "Indirizzo dove consegnare, es. \"Via Roma 1, 20121 Milano\""
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Numero massimo di risultati (default 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Ritorna il dettaglio di un oggetto a noleggio: descrizione, tariffe (ora/giorno/mese), foto, periodi già occupati, regole (orari di consegna, anticipo minimo, annullamento) e, se passi indirizzo_consegna, se la consegna lì è possibile. Chiamalo prima di rentme_book_thing per scegliere date libere e tariffa.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Id dell'oggetto, da rentme_search_things"
    },
    "indirizzo_consegna": {
      "type": "string",
      "description": "Indirizzo di consegna da verificare"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Invia una richiesta di noleggio per conto di una persona. Il proprietario (Runner) ha 24 ore per accettare; quando accetta, la persona riceve per email un link di pagamento con carta da usare entro 12 ore (lo trovi anche in rentme_check_rental_status). Solo dopo il pagamento il noleggio è confermato e si scambiano i contatti. Chiedi sempre conferma alla persona prima di prenotare, mostrando periodo e prezzo totale. Conserva id e codice_accesso restituiti: servono per controllare lo stato o annullare.

{
  "type": "object",
  "properties": {
    "thing_id": {
      "type": "integer",
      "description": "Id dell'oggetto"
    },
    "tipo_tariffa": {
      "type": "string",
      "enum": [
        "ora",
        "giorno",
        "mese"
      ],
      "description": "Tariffa da usare: deve essere tra quelle offerte dall'oggetto"
    },
    "data_inizio": {
      "type": "string",
      "description": "Data e ora di consegna, formato \"YYYY-MM-DD HH:MM\", tra le 07:00 e le 21:00, minuti 00 o 30"
    },
    "quantita": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Durata: numero di ore, giorni o mesi secondo tipo_tariffa"
    },
    "indirizzo_consegna": {
      "type": "string",
      "description": "Indirizzo completo di consegna: via, numero, CAP, città"
    },
    "nome_cliente": {
      "type": "string",
      "description": "Nome e cognome di chi riceve l'oggetto"
    },
    "telefono_cliente": {
      "type": "string",
      "description": "Telefono di chi riceve l'oggetto (lo userà il Runner per la consegna)"
    },
    "email_cliente": {
      "type": "string",
      "format": "email",
      "description": "Email di chi noleggia: riceverà link di pagamento e conferme"
    },
    "note": {
      "type": "string",
      "description": "Note per il Runner, es. citofono, piano"
    },
    "riferimento_ai": {
      "type": "string",
      "description": "Riferimento a piacere per il tuo sistema"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "URL https:// per ricevere notifiche automatiche ai cambi di stato"
    }
  },
  "required": [
    "thing_id",
    "tipo_tariffa",
    "data_inizio",
    "quantita",
    "indirizzo_consegna",
    "nome_cliente",
    "telefono_cliente",
    "email_cliente"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Stato di un noleggio richiesto con rentme_book_thing: richiesto (in attesa del Runner), da_pagare (contiene link_pagamento da dare alla persona), confermato (contiene nome e contatto del Runner), consegnato, completato, rifiutato, scaduto, annullato.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Id del noleggio"
    },
    "codice_accesso": {
      "type": "string",
      "description": "Codice di accesso restituito da rentme_book_thing"
    }
  },
  "required": [
    "id",
    "codice_accesso"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Annulla per conto della persona un noleggio richiesto con rentme_book_thing. Gratis prima del pagamento. Dopo il pagamento: fino a 24 ore prima della consegna rimborso meno il 3% di spese (min 1 EUR); a meno di 24 ore nessun rimborso. Chiedi conferma alla persona prima di annullare.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Id del noleggio"
    },
    "codice_accesso": {
      "type": "string",
      "description": "Codice di accesso restituito da rentme_book_thing"
    }
  },
  "required": [
    "id",
    "codice_accesso"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}