---
title: "As regras, e o que o TourCockpit recusa"
url: https://tourcockpit.com/pt/help/rules-and-refusals
lang: pt
description: "Tudo o que o TourCockpit permite e recusa, num só lugar, com o motivo. As mesmas regras valem nos ecrãs do escritório, no portal do operador turístico e através da API, pelo que uma reserva recusada num é recusada em todos. No fim da página, os nomes que os dados e a API usam para cada elemento, valor e recusa."
---

# As regras, e o que o TourCockpit recusa

Tudo o que o TourCockpit permite e recusa, num só lugar, com o motivo. As mesmas regras valem nos ecrãs do escritório, no portal do operador turístico e através da API, pelo que uma reserva recusada num é recusada em todos. No fim da página, os nomes que os dados e a API usam para cada elemento, valor e recusa.

## Lugares

- Cada pessoa ocupa um lugar. Adultos, crianças e bebés contam todos: seis adultos e dois bebés enchem uma carrinha de oito lugares.
- Só um cancelamento liberta um lugar. Uma reserva ocupa os seus lugares até ser cancelada, pelo que os lugares livres de uma partida são os seus lugares menos as pessoas das reservas em vigor.
- A carrinha define os lugares. Atribuir uma carrinha dá à partida o número de lugares dessa carrinha; retirá-la repõe o valor predefinido da empresa.
- Uma excursão privada vende-se inteira. Assim que um grupo está numa partida de uma excursão vendida por veículo, não se adiciona mais ninguém, sejam quais forem os lugares vazios, nem pelo escritório nem por uma agência.
- Uma reserva é um grupo. Um conjunto de grupos são várias reservas, cada uma por si.

## Quem pode ir numa partida

- O guia fala o idioma da reserva. Uma reserva só vai numa partida cujo guia, ou um guia do seu convoy, fale o seu idioma. O escritório também está sujeito a isto, sem exceção. Uma partida ainda sem guia aceita qualquer idioma, e um guia sem idiomas registados não fala nenhum.
- Um novo guia tem de cobrir o que está reservado. Atribuir um guia, desligar um convoy ou retirar um idioma a um guia é recusado quando deixaria uma reserva sem ninguém que fale o seu idioma.
- Dois idiomas por partida, para uma agência. Os dois primeiros idiomas reservados preenchem uma partida para as agências; um idioma que já lá está é sempre aceite. Uma reserva introduzida pelo escritório recebe antes um aviso.
- Reservada para algumas agências. Uma partida reservada para agências indicadas é oferecida apenas a essas agências; nenhuma indicada significa todas. Uma reserva introduzida pelo escritório não é verificada face a isto.
- Apenas adultos. Uma excursão marcada como apenas adultos não aceita crianças nem bebés, nem sequer num lugar gratuito.
- Sem tarifa de criança, sem criança. Uma excursão por pessoa sem tarifa de criança não pode aceitar uma criança. Registar a criança como adulto nunca é a solução.
- Maior do que aquilo para que o veículo é vendido. Uma excursão privada só aceita um grupo até à sua maior linha de preço.
- Uma partida cancelada não aceita ninguém. As reservas e as mudanças para ela são recusadas.
- Uma excursão arquivada não é colocada. Não pode ser posta num dia até ser publicada de novo.

## Quando é que um grupo cabe numa partida?

Quando uma agência procura uma partida com os seus passageiros, um idioma ou um hotel, uma partida fica de fora por um destes motivos, e o portal diz qual:

- Está esgotada, ou tem alguns lugares mas menos do que o grupo.
- O seu guia não fala o idioma.
- Já leva outros dois idiomas, que é o limite da agência.
- A excursão não para na zona de recolha do hotel.
- O grupo tem crianças ou bebés e a excursão é só para adultos.
- O grupo tem crianças e a excursão não vende tarifa de criança.
- É uma partida privada já ocupada.

## Tempo: o prazo de reserva e o pré-aviso de cancelamento

- O prazo de reserva. As reservas fecham as horas de prazo da empresa (12, salvo se a empresa tiver definido outro número) antes da hora de início da partida, ou antes das 08:00 quando a partida não tem, segundo o relógio da empresa. Uma reserva introduzida pelo escritório depois do prazo é aceite após uma confirmação, e fica registado que o foi. Uma reserva que uma agência faz através do portal não é verificada face ao prazo.
- O pré-aviso de cancelamento. Através do portal, uma reserva da própria agência pode ser cancelada até ao pré-aviso da empresa antes do início, que é de pelo menos 24 horas; o próprio minuto do prazo já é tarde demais, e depois dele a agência liga para o escritório. O pré-aviso aplica-se apenas ao portal.
- Horas do relógio de parede. 24 horas antes das 08:00 são as 08:00 do dia anterior, nos dois dias por ano em que a hora muda tal como em qualquer outro dia.

## Dinheiro: preços, lugares gratuitos e cobranças a bordo

- Uma só regra de preço. Por pessoa: adultos vezes a tarifa de adulto, crianças vezes a tarifa de criança, bebés vezes a tarifa de bebé, que é zero salvo se a excursão definir uma. Por veículo: a primeira linha de preço em que o grupo cabe, cobrada uma vez pelo veículo inteiro, seja quem for que vá nele.
- Uma zona pode mudar o preço. Um preço de zona substitui a tarifa da excursão a partir dessa zona, adulto e criança cada um por si, e as linhas de preço de uma excursão privada podem ser substituídas por zona da mesma forma.
- O preço mantém-se. Uma reserva mantém o preço com que foi feita. O preço só volta a ser calculado por uma mudança de grupo, de hotel, para gratuito ou de gratuito, ou uma mudança para outra excursão ou data. Uma alteração às tarifas da excursão não mexe em nada já reservado.
- Uma excursão privada precisa de um preço. Uma excursão vendida por veículo sem linhas de preço não pode ser reservada.
- Um lugar gratuito não custa nada. O seu valor é zero pelo seu tipo, nunca escrito à mão. Tornar um lugar gratuito, ou cobrar um que era gratuito, é verificado à parte, separado do resto da reserva, que pode ser editada como qualquer outra.
- Dinheiro só em CASH. Uma reserva CASH precisa do valor que o guia cobra; qualquer outro pagamento não tem nenhum. Nada o calcula: é o que foi acordado.
- Dinheiro dentro do valor. O dinheiro a cobrar pode igualar o valor da reserva, nunca mais.
- Uma nova excursão tem de dar preço a cada grupo. Mudar a excursão de uma partida já colocada é recusado quando um grupo não tem preço na nova excursão, ou quando o seu dinheiro seria superior ao seu novo valor. Nada muda até as duas coisas estarem corrigidas.
- Dois valores, nunca misturados. O que as reservas valiam e o dinheiro que os guias cobraram a bordo são valores diferentes, e nenhum é apresentado como o outro nem somado a ele. Uma reserva CASH vale o seu preço; o dinheiro é apenas a parte com que a agência não ficou ao balcão.
- O dinheiro conta o que se realizou. Um valor em dinheiro conta as partidas com data até hoje, segundo o relógio da empresa: uma partida ainda por vir ainda não é dinheiro.

## Recolha: hotéis e horas

- O hotel está na lista. O hotel de uma reserva é um dos hotéis da empresa. Um hotel novo é adicionado à lista, com a sua zona, antes de ser reservado.
- A hora vem da grelha. A hora de recolha é a hora da grelha para a excursão da partida e a zona do hotel, para o tamanho de veículo da partida quando esse tamanho tem a sua própria linha.
- Uma célula diz uma de três coisas. Uma hora; sem paragem, o que significa que a excursão não faz recolha ali; ou por definir, o que significa que ninguém disse ainda. Sem paragem é uma resposta e por definir é uma pergunta.
- Uma hora escrita mantém-se. Uma hora definida à mão nunca muda sozinha; uma hora vinda da grelha acompanha uma mudança de excursão, de hotel ou de partida.
- O portal não define uma hora. Uma reserva feita através do portal fica com a hora da grelha, ou espera que o escritório defina uma.

## Equipa: guias, motoristas e carrinhas

- Sem sobreposições. Um guia, um CHOFER ou uma carrinha está numa só partida por horário. Uma manhã e uma tarde cabem num dia; um dia inteiro ocupa o dia.
- Uma mudança de horário não pode criar uma sobreposição. O horário de uma excursão não pode mudar se um dia passasse a ter uma sobreposição.
- Não as duas funções. Uma pessoa nunca é o guia e o CHOFER da mesma partida.
- Folga é folga. Um guia de folga nesse dia não pode ser atribuído, e um guia numa partida não pode ser marcado de folga nesse dia.
- Todos na escala falam alguma língua. Uma pessoa na escala de guias tem pelo menos um idioma, e cada um é um dos idiomas da empresa. Numa partida só contam os idiomas do guia, nunca os do CHOFER.

## Partidas e convoys

- Só se cancela uma partida vazia. Mova ou cancele primeiro as suas reservas.
- São permitidas partidas em paralelo. A mesma excursão pode realizar-se várias vezes no mesmo dia, cada uma como partida própria com os seus lugares e a sua equipa.
- Mover leva a lista de passageiros. Mover uma partida para outro dia move todas as reservas dela.
- Um convoy é um dia e um destino. Só se podem ligar partidas do painel, na mesma data e da mesma família, e duas partidas que já estão cada uma num convoy não se ligam entre si: desligue primeiro uma. Cada uma mantém os seus próprios lugares e as suas próprias reservas.
- Medio Día não tem duração. Uma partida de Medio Día conta como Medio Día seja qual for a duração indicada nela. Uma excursão da manhã de outra família mantém a sua duração.
- Uma nova ordem inclui todas. Reordenar as partidas de um dia, ou as reservas de uma partida, tem de incluir exatamente as que lá estão.

## Pessoas, só de leitura e uma empresa de cada vez

- Uma empresa de cada vez. Cada leitura e cada alteração acontecem dentro de uma só empresa. Os valores nunca são somados nem comparados entre empresas.
- Uma associação só de leitura. Mostra o trabalho da empresa sem o alterar. O que é da própria pessoa continua a ser seu: o perfil, o idioma e a palavra-passe, as escolhas de notificações, que elementos das Notificações já leu e o painel enviado a si própria.
- O idioma de uma pessoa é seu. Cada pessoa define o idioma em que o TourCockpit lhe fala, e esse idioma acompanha-a em todos os dispositivos.
- Um endereço de e-mail pertence a uma só pessoa. Convidar um endereço já em uso é recusado.
- Um pedido de inscrição decide-se uma só vez. Depois de convidado ou recusado, não pode ser decidido de novo.
- Desfazer uma alteração. Uma alteração no Registo de atividade só pode ser revertida enquanto nada a tiver alterado desde então. Algumas alterações nunca são revertidas: o início de sessão e outras alterações de acesso, os convites, uma mudança de empresa, um ficheiro que já saiu, uma alteração feita em massa, as alterações a uma pessoa, a uma chave de API ou à própria definição de uma excursão (os seus dados, as suas paragens do percurso, as suas linhas de preço e as agências para as quais está reservada por predefinição), uma hora de recolha definida na grelha, uma nova linha de Dados de referência, uma partida eliminada, um estado de reserva que não seja um simples cancelamento, e as agências para as quais uma partida está reservada quando são alteradas por si só. Uma entrada que não pode ser desfeita não tem Reverter.

## Nomes na API e nas exportações: os elementos

A API, as exportações e tudo o que é construído sobre elas usam os nomes próprios dos dados. São os mesmos elementos da página Como tudo se encaixa.

| Nome nos dados | Palavra do produto |
| --- | --- |
| Company | Empresa |
| Tour | Excursão |
| TourInstance | Partida |
| Booking | Reserva |
| Passenger | Grupo |
| Driver | Guia ou CHOFER |
| DriverLanguage | Idiomas de um guia |
| Vehicle | Carrinha |
| TourOperator | Operador |
| TourReservedOperator | Agências para as quais uma excursão está reservada |
| TourInstanceReservedOperator | Agências para as quais uma partida está reservada |
| Hotel | Hotel |
| Zone | Zona de recolha |
| TourZonePickupTime | Grelha de recolha |
| TourZonePrice | Preço por zona |
| TourVehiclePrice | Preço por veículo |
| TourStop | Paragem do percurso |
| Language | Idioma |
| ChildSeatOption | Cadeira de criança |
| PickupTimeOption | Opção de hora de recolha |
| DriverDayAvailability | Descanso |
| DailyNote | Nota do dia |
| User | Pessoa |
| UserCompany | Associação |
| Audit | Entrada do histórico |
| OperatorSignupRequest | Pedido de inscrição |

## Nomes na API e nas exportações: excursões e partidas

| Nome nos dados | Valor | Palavra do produto |
| --- | --- | --- |
| TourStatus | PUBLISHED | Publicada |
| TourStatus | ARCHIVED | Arquivada |
| TourPriceMode | PER_PERSON | por pessoa |
| TourPriceMode | PER_DEPARTURE | por veículo |
| TourSlot | MORNING | manhã |
| TourSlot | AFTERNOON | tarde |
| TourSlot | FULL_DAY | dia inteiro |
| DestinationZone | NORTE | NORTE |
| DestinationZone | SUR | SUR |
| DestinationZone | HALF_DAY_MORNING | Medio Día, manhã |
| DestinationZone | HALF_DAY_AFTERNOON | Medio Día, tarde |
| DestinationZone | PRIVATE | Privado |
| DestinationZone | TREKKING | Trekking |
| DestinationZone | FAM_TRIP | Fam trip |
| PickupZone | norte | parte do norte |
| PickupZone | sur | parte do sul |
| TourLength | LARGO | LARGO |
| TourLength | CORTO | CORTO |
| TourInstanceStatus | SCHEDULED | no painel |
| TourInstanceStatus | CANCELLED | cancelada |

## Nomes na API e nas exportações: reservas

| Nome nos dados | Valor | Palavra do produto |
| --- | --- | --- |
| BookingStatus | CONFIRMED | reservada |
| BookingStatus | CANCELLED | cancelada |
| PaymentType | CASH | CASH |
| PaymentType | TKT | TKT |
| PaymentType | PREPAID | pré-pago |
| PaymentType | FREE | lugar gratuito |
| PickupTimeSource | GRID | da grelha |
| PickupTimeSource | MANUAL | definida à mão |
| BookedByType | MANAGER | reservada pelo escritório |
| BookedByType | OPERATOR | reservada por uma agência |

## Nomes na API e nas exportações: pessoas, guias e empresas

| Nome nos dados | Valor | Palavra do produto |
| --- | --- | --- |
| UserRole | ADMIN | Proprietário: a mesma função com dois nomes |
| UserRole | MANAGER | Gestor |
| UserRole | OPERATOR | utilizador de agência |
| DriverAvailabilityStatus | DAY_OFF | Descanso |
| DriverAvailabilityStatus | OFFICE | Escritório |
| DriverAvailabilityStatus | VACATION | Férias |
| DriverAvailabilityStatus | SICK | Baixa |
| DriverAvailabilityStatus | AVAILABLE | nunca guardado: escolher Disponível remove o dia de descanso |
| CompanyKind | LIVE | a empresa |
| CompanyKind | SANDBOX | sandbox |
| CompanyKind | DEMO | demonstração |
| CompanyKind | ARCHIVE | arquivo |
| OperatorSignupRequestStatus | PENDING | pendente |
| OperatorSignupRequestStatus | APPROVED | convidado |
| OperatorSignupRequestStatus | DECLINED | recusado |

## Códigos de recusa: lugares, passageiros, preços e dinheiro

| Recusa | O que significa |
| --- | --- |
| CAPACITY_FULL | Não restam lugares suficientes para o grupo. |
| DEPARTURE_TAKEN | Uma partida privada já tem o seu grupo. |
| ADULTS_ONLY | A excursão não aceita crianças nem bebés. |
| CHILD_PRICING_UNAVAILABLE | A excursão não tem tarifa de criança. |
| PARTY_ABOVE_LAST_TIER | O grupo é maior do que a maior linha de preço da excursão privada. |
| NO_VEHICLE_PRICE | Uma excursão vendida por veículo ainda não tem linhas de preço. |
| HOTEL_NOT_FOUND | O hotel não está na lista da empresa. |
| CASH_AMOUNT_REQUIRED | Uma reserva CASH precisa do dinheiro a cobrar. |
| CASH_AMOUNT_NOT_ALLOWED | Só uma reserva CASH tem dinheiro a cobrar. |
| CASH_ABOVE_VALUE | O dinheiro a cobrar é superior ao valor da reserva. |
| FREE_SEAT_MANAGER_ONLY | Tornar um lugar gratuito, ou cobrar um que era gratuito, não faz parte deste acesso. |
| TOUR_CHANGE_CANNOT_PRICE | A nova excursão não tem preço para um dos grupos. |
| TOUR_CHANGE_BELOW_CASH | Ao preço da nova excursão, o dinheiro de um grupo seria superior ao seu valor. |

## Códigos de recusa: partidas, idiomas e agências

| Recusa | O que significa |
| --- | --- |
| INSTANCE_NOT_FOUND | Essa partida não existe nesta empresa. |
| INSTANCE_CANCELLED | A partida está cancelada. |
| INSTANCE_HAS_BOOKINGS | A partida ainda tem reservas em vigor. |
| TOUR_ARCHIVED | A excursão está arquivada, pelo que não pode ser colocada num dia. |
| LANGUAGE_NOT_SPOKEN | Nenhum guia da partida ou do seu convoy fala o idioma da reserva. |
| GUIDE_LANGUAGE_UNCOVERED | A alteração deixaria uma reserva sem ninguém que fale o seu idioma. |
| DEPARTURE_LANGUAGES_FULL | Já há outros dois idiomas na partida, o limite de uma agência. |
| TOUR_NOT_AVAILABLE | A partida está reservada para outras agências. |
| PAST_CUTOFF | A partida já passou o prazo de reserva. |
| PAST_CANCELLATION_NOTICE | O cancelamento gratuito da agência para esta reserva terminou. |
| DIFFERENT_DAYS | Um convoy realiza-se num só dia. |
| DIFFERENT_DESTINATION | Um convoy vai a um só destino. |
| NOT_SCHEDULED | Só se podem ligar partidas do painel. |
| ALREADY_LINKED | As duas partidas já estão em convoys, ou no mesmo. |
| ORDER_CHANGED | Uma nova ordem não inclui exatamente o que lá está. |

## Códigos de recusa: a equipa e a escala de guias

| Recusa | O que significa |
| --- | --- |
| GUIDE_ALREADY_ASSIGNED | O guia já está em serviço nesse horário nesse dia. |
| CHAUFFEUR_ALREADY_ASSIGNED | O CHOFER já está em serviço nesse horário nesse dia. |
| VEHICLE_ALREADY_ASSIGNED | A carrinha já circula nesse horário nesse dia. |
| CREW_DUPLICATE | Uma pessoa não pode ser ao mesmo tempo o guia e o CHOFER. |
| SLOT_CHANGE_CONFLICT | Mudar o horário da excursão criaria uma sobreposição. |
| DRIVER_OFF | O guia está de folga nesse dia. |
| DRIVER_ASSIGNED | O guia está numa partida nesse dia, pelo que não pode ser marcado de folga. |
| DRIVER_LANGUAGE_REQUIRED | Uma pessoa na escala precisa de pelo menos um idioma. |
| DRIVER_LANGUAGE_UNKNOWN | Um idioma não é um dos idiomas da empresa. |

## Códigos de recusa: pessoas, acesso e a própria API

| Recusa | O que significa |
| --- | --- |
| NOT_FOUND | Esse registo não existe nesta empresa. Os registos de outra empresa também recebem esta resposta. |
| INVALID | O pedido não faz sentido tal como foi enviado; a mensagem diz porquê. |
| VALIDATION_FAILED | Falta um campo ou tem um formato errado. |
| UNAUTHORIZED | Sessão não iniciada, ou a chave não é válida. |
| FORBIDDEN | Isto não faz parte deste acesso. |
| READ_ONLY | A associação é só de leitura. |
| LANGUAGE_OWNER_ONLY | Mudar o idioma de outra pessoa não faz parte deste acesso. |
| NOT_A_PERSON | Uma chave da empresa não tem um idioma próprio para mudar. |
| EMAIL_TAKEN | O endereço de e-mail já está em uso. |
| REQUEST_DECIDED | O pedido de inscrição já foi decidido. |
| REVERT_REFUSED | Essa alteração não pode ser revertida; a mensagem diz porquê. |
| CONFLICT | Outra coisa alterou os mesmos dados no mesmo momento, ou o valor já existe. Nada foi alterado. |
| RATE_LIMITED | Demasiados pedidos em pouco tempo. Tente novamente mais tarde. |
| BATCH_ITEM_NOT_A_WRITE | Um elemento de um lote não é uma alteração que a API faça. |
| BATCH_ITEM_STANDALONE | Um elemento envia algo ou produz efeito fora do lote, pelo que é feito à parte. |
| BATCH_REF_UNRESOLVED | Um elemento usa o id de um elemento anterior que não criou nada. Nada foi alterado. |

## Códigos de recusa: envio do painel e mensagens

| Recusa | O que significa |
| --- | --- |
| NO_CONTACT | Não há nenhum número de WhatsApp nem endereço de e-mail para onde enviar o painel. |
| TOO_LARGE | O ficheiro é demasiado grande para ser enviado assim. Transfira-o ou envie o PDF. |
| RENDER_FAILED | Não foi possível gerar o ficheiro. |
| STORE_FAILED | Não foi possível guardar o ficheiro, pelo que nada foi enviado. |
| NOT_READY | O WhatsApp ainda não está pronto para este ficheiro. Envie-o por e-mail. |
| UPLOAD_FAILED | Não foi possível entregar o ficheiro ao WhatsApp, pelo que nada foi enviado. |
| NOT_DELIVERED | O ficheiro foi criado, mas não foi possível entregá-lo. |
| TIMED_OUT | O WhatsApp não confirmou o ficheiro a tempo. Ainda pode chegar. |
| SEND_FAILED | Não foi possível enviar uma mensagem do formulário de contacto público. |
| TOO_MANY_REQUESTS | Demasiadas mensagens do formulário de contacto. Tente novamente mais tarde. |

## Códigos de recusa: início de sessão, palavras-passe e pedidos

| Recusa | O que significa |
| --- | --- |
| INVALID_CREDENTIALS | O endereço de e-mail ou a palavra-passe está errado. |
| LINK_INVALID | A ligação para escolher uma palavra-passe não é válida, já foi usada ou expirou. |
| ALREADY_SET | Já existe uma palavra-passe definida. Altere-a em vez disso. |
| NO_PASSWORD_SET | Ainda não há palavra-passe para alterar. Escolha uma primeiro. |
| CURRENT_PASSWORD_WRONG | A palavra-passe atual não é a correta. |
| INVALID_LOCALE | Não é um dos idiomas que o TourCockpit fala. |
| BAD_REQUEST | O histórico foi pedido sem uma data ou um registo válidos. |
| BATCH_ITEM_REFUSED | Um elemento do lote foi recusado, pelo que nada do lote foi feito. |

## Nomes na API: porque é que um grupo não cabe

| Motivo | O que significa |
| --- | --- |
| FULL | Não restam lugares. |
| NOT_ENOUGH_SEATS | Alguns lugares, menos do que o grupo. |
| LANGUAGE | O guia não fala o idioma. |
| LANGUAGES_FULL | Já leva outros dois idiomas. |
| NO_STOP | A excursão não faz recolha na zona do hotel. |
| ADULTS_ONLY | Crianças ou bebés no grupo. |
| NO_CHILDREN | Crianças, e a excursão não vende tarifa de criança. |
| TAKEN | Uma partida privada que já tem o seu grupo. |

## Nomes na API: por que critérios se pode discriminar um valor

| Código | Nível | Agrupa por |
| --- | --- | --- |
| guide | partida | o guia da partida, ou sem atribuição |
| van | partida | a carrinha da partida |
| tour | partida | a excursão |
| day | partida | a data da partida |
| month | partida | o mês da partida |
| zone | reserva | a zona de recolha do hotel da reserva |
| hotel | reserva | o hotel da reserva |
| operator | reserva | o operador turístico, ou as reservas próprias do escritório |
| language | reserva | o idioma da reserva |
| payment | reserva | CASH, TKT, pré-pago ou grátis |
| entered | reserva | o dia em que a reserva foi introduzida, segundo o relógio da empresa |