Como funcionam as ocorrências logísticas

As ocorrências logísticas são eventos ocorridos durante a operação de transporte que tem a finalidade de informar o sistema que aquele evento ocorreu, assim o sistema pode iniciar os processos correspondentes, como por exemplo a liberação de um pagamento quando o transporte for concluído.

As ocorrências são sinalizadas pelo motorista que as registra no sistema do TMS, que por sua vez integra com o NDD Frete Embarcador o qual atribui a ocorrência com os documentos relacionados àquele evento.

Eventos utilizados pelo NDD Frete

IOD (Information of Delivery): A informação da entrega é uma sinalização sistêmica para declarar que as mercadorias foram entregues;
POD (Proof of Delivery): Refere-se à prova de entrega, com documento assinado e fotografado;
Liberação de pagamento: Qualquer evento ocorrido na viagem que tem caráter de liberar o pagamento para o prestador de serviço.

Integração TMS para NDD Frete Embarcador

As ocorrências podem ser integradas do TMS com o NDD Frete das seguintes formas:

Embarque: Através da atualização do embarque contendo a ocorrência é possível atribuí-la aos documentos;
Status do Embarque: Com uma integração exclusiva de ocorrências o NDD Frete permite receber as ocorrências e atribuí-las aos documentos correspondentes.

Modelos de ocorrências

As ocorrências são vinculadas aos documentos de transporte através das notas entregues e podem ser informadas das seguintes maneiras:

Por Parada: Ao informar a ocorrência por parada do embarque, será atribuída a ocorrência informada para todas as notas das ordens vinculadas à parada informada;
Por Nota: Ocorrências integradas por chave de NF-e serão atribuídas a todas as NF-es vinculadas à Ordem da NF-e informada no evento;
Por Embarque: Quando for informado apenas o embarque na ocorrência, a ocorrência informada será atribuída à todas as notas daquele embarque.

Exemplos de estruturas das ocorrências

Por Parada

CODE

<Transmission>
	<TransmissionHeader>
		<Version>21c</Version>
		<TransmissionCreateDt>
			<GLogDate>20220331123016</GLogDate>
			<TZId>GMT</TZId>
			<TZOffset>+00:00</TZOffset>
		</TransmissionCreateDt>
		<TransactionCount>1</TransactionCount>
		<SenderHostName>https://tms-exemplo:443</SenderHostName>
		<SenderSystemID>https://tms-exemplo:443</SenderSystemID>
		<SenderTransmissionNo>55380</SenderTransmissionNo>
		<ReferenceTransmissionNo>0</ReferenceTransmissionNo>
		<GLogXMLElementName>ShipmentStatus</GLogXMLElementName>
		<NotifyInfo>
			<ContactGid>
				<Gid>
					<DomainName>EMBDEV</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ContactGid>
			<ExternalSystemGid>
				<Gid>
					<DomainName>EMBDEV</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ExternalSystemGid>
		</NotifyInfo>
	</TransmissionHeader>
	<TransmissionBody>
		<GLogXMLElement>
			<TransactionHeader>
				<SenderTransactionId>29597</SenderTransactionId>
				<SendReason>
					<Remark>
						<RemarkSequence>1</RemarkSequence>
						<RemarkQualifierGid>
							<Gid>
								<Xid>QUERY TYPE</Xid>
							</Gid>
						</RemarkQualifierGid>
						<RemarkText>SERVPROV</RemarkText>
					</Remark>
					<SendReasonGid>
						<Gid>
							<Xid>SEND INTEGRATION</Xid>
						</Gid>
					</SendReasonGid>
					<ObjectType>SERVICE_PROVIDER</ObjectType>
				</SendReason>
			</TransactionHeader>
			<ShipmentStatus>
				<SendReason>
					<Remark>
						<RemarkSequence>1</RemarkSequence>
						<RemarkQualifierGid>
							<Gid>
								<Xid>QUERY TYPE</Xid>
							</Gid>
						</RemarkQualifierGid>
						<RemarkText>TRACKING EVENT</RemarkText>
					</Remark>
					<SendReasonGid>
						<Gid>
							<Xid>SEND INTEGRATION</Xid>
						</Gid>
					</SendReasonGid>
					<ObjectType>TRACKING EVENT</ObjectType>
				</SendReason>
				<StatusCodeGid>
					<Gid>
						<DomainName>EMBDEV</DomainName>
						<Xid>IOD</Xid>
					</Gid>
				</StatusCodeGid>
				<TimeZoneGid>
					<Gid>
						<Xid>UTC</Xid>
					</Gid>
				</TimeZoneGid>
				<EventDt>
					<GLogDate>20190705121000</GLogDate>
					<TZId>UTC</TZId>
					<TZOffset>+00:00</TZOffset>
				</EventDt>
				<ResponsiblePartyGid>
					<Gid>
						<Xid>CARRIER</Xid>
					</Gid>
				</ResponsiblePartyGid>
				<EventRecdDate>
					<GLogDate>20190705121000</GLogDate>
					<TZId>UTC</TZId>
					<TZOffset>+00:00</TZOffset>
				</EventRecdDate>
				<SSStop>
					<SSStopSequenceNum>1</SSStopSequenceNum>
				</SSStop>
				<ShipmentGid>
					<Gid>
						<DomainName>SHIPMENT_DOMAIN_NAME</DomainName>
						<Xid>SHIPMENT_XID</Xid>
					</Gid>
				</ShipmentGid>
				<ReportingUser>USUARIO</ReportingUser>
			</ShipmentStatus>
		</GLogXMLElement>
	</TransmissionBody>
</Transmission>

Por Nota

CODE

<Transmission>
	<TransmissionHeader>
		<Version>21c</Version>
		<TransmissionCreateDt>
			<GLogDate>20220331123016</GLogDate>
			<TZId>GMT</TZId>
			<TZOffset>+00:00</TZOffset>
		</TransmissionCreateDt>
		<TransactionCount>1</TransactionCount>
		<SenderHostName>https://tms-exemplo:443</SenderHostName>
		<SenderSystemID>https://tms-exemplo:443</SenderSystemID>
		<SenderTransmissionNo>55380</SenderTransmissionNo>
		<ReferenceTransmissionNo>0</ReferenceTransmissionNo>
		<GLogXMLElementName>ShipmentStatus</GLogXMLElementName>
		<NotifyInfo>
			<ContactGid>
				<Gid>
					<DomainName>EMBDEV</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ContactGid>
			<ExternalSystemGid>
				<Gid>
					<DomainName>EMBDEV</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ExternalSystemGid>
		</NotifyInfo>
	</TransmissionHeader>
	<TransmissionBody>
		<GLogXMLElement>
			<TransactionHeader>
				<SenderTransactionId>29597</SenderTransactionId>
				<SendReason>
					<Remark>
						<RemarkSequence>1</RemarkSequence>
						<RemarkQualifierGid>
							<Gid>
								<Xid>QUERY TYPE</Xid>
							</Gid>
						</RemarkQualifierGid>
						<RemarkText>SERVPROV</RemarkText>
					</Remark>
					<SendReasonGid>
						<Gid>
							<Xid>SEND INTEGRATION</Xid>
						</Gid>
					</SendReasonGid>
					<ObjectType>SERVICE_PROVIDER</ObjectType>
				</SendReason>
			</TransactionHeader>
			<ShipmentStatus>
				<SendReason>
					<Remark>
						<RemarkSequence>1</RemarkSequence>
						<RemarkQualifierGid>
							<Gid>
								<Xid>QUERY TYPE</Xid>
							</Gid>
						</RemarkQualifierGid>
						<RemarkText>TRACKING EVENT</RemarkText>
					</Remark>
					<SendReasonGid>
						<Gid>
							<Xid>SEND INTEGRATION</Xid>
						</Gid>
					</SendReasonGid>
					<ObjectType>TRACKING EVENT</ObjectType>
				</SendReason>
				<StatusCodeGid>
					<Gid>
						<DomainName>EMBDEV</DomainName>
						<Xid>IOD</Xid>
					</Gid>
				</StatusCodeGid>
				<TimeZoneGid>
					<Gid>
						<Xid>UTC</Xid>
					</Gid>
				</TimeZoneGid>
				<EventDt>
					<GLogDate>20190705121000</GLogDate>
					<TZId>UTC</TZId>
					<TZOffset>+00:00</TZOffset>
				</EventDt>
				<ResponsiblePartyGid>
					<Gid>
						<Xid>CARRIER</Xid>
					</Gid>
				</ResponsiblePartyGid>
				<EventRecdDate>
					<GLogDate>20190705121000</GLogDate>
					<TZId>UTC</TZId>
					<TZOffset>+00:00</TZOffset>
				</EventRecdDate>
				<ReleaseRefnum>
					<ReleaseRefnumQualifierGid>
						<Gid>
							<DomainName>EMBDEV</DomainName>
							<Xid>CLL_NFE_CHAVE</Xid>
						</Gid>
					</ReleaseRefnumQualifierGid>
<ReleaseRefnumValue>00000000000000000000000000000000000000000000</ReleaseRefnumValue>
				</ReleaseRefnum>
				<ShipmentGid>
					<Gid>
						<DomainName>SHIPMENT_DOMAIN_NAME</DomainName>
						<Xid>SHIPMENT_XID</Xid>
					</Gid>
				</ShipmentGid>
				<ReportingUser>USUARIO</ReportingUser>
			</ShipmentStatus>
		</GLogXMLElement>
	</TransmissionBody>
</Transmission>

Por Embarque

CODE

<Transmission>
	<TransmissionHeader>
		<Version>21c</Version>
		<TransmissionCreateDt>
			<GLogDate>20220331123016</GLogDate>
			<TZId>GMT</TZId>
			<TZOffset>+00:00</TZOffset>
		</TransmissionCreateDt>
		<TransactionCount>1</TransactionCount>
		<SenderHostName>https://tms-exemplo:443</SenderHostName>
		<SenderSystemID>https://tms-exemplo:443</SenderSystemID>
		<SenderTransmissionNo>58352</SenderTransmissionNo>
		<ReferenceTransmissionNo>0</ReferenceTransmissionNo>
		<GLogXMLElementName>PlannedShipment</GLogXMLElementName>
		<NotifyInfo>
			<ContactGid>
				<Gid>
					<DomainName>DOMAIN_NAME</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ContactGid>
			<ExternalSystemGid>
				<Gid>
					<DomainName>DOMAIN_NAME</DomainName>
					<Xid>EXTERNAL_SYSTEM</Xid>
				</Gid>
			</ExternalSystemGid>
		</NotifyInfo>
	</TransmissionHeader>
	<TransmissionBody>
		<GLogXMLElement>
			<TransactionHeader>
				<SenderTransactionId>29923</SenderTransactionId>
				<SendReason>
					<Remark>
						<RemarkSequence>1</RemarkSequence>
						<RemarkQualifierGid>
							<Gid>
								<Xid>QUERY TYPE</Xid>
							</Gid>
						</RemarkQualifierGid>
						<RemarkText>SHIPMENT</RemarkText>
					</Remark>
					<SendReasonGid>
						<Gid>
							<Xid>SEND INTEGRATION</Xid>
						</Gid>
					</SendReasonGid>
					<ObjectType>SHIPMENT</ObjectType>
				</SendReason>
			</TransactionHeader>
			<PlannedShipment>
				<Shipment>
					<ShipmentHeader>
						<ShipmentGid>
							<Gid>
								<DomainName>DOMAIN_NAME</DomainName>
								<Xid>SHIPMENT_XID</Xid>
							</Gid>
						</ShipmentGid>
				<RATE_RULES_AND_TERMS/>
						</RATE_OFFERING_ROW>
					</RATE_OFFERING>
					<ShipmentStatus>
						<ShipmentRefnum>
							<ShipmentRefnumQualifierGid>
								<Gid>
									<Xid>GLOG</Xid>
								</Gid>
							</ShipmentRefnumQualifierGid>
		<ShipmentRefnumValue>DOMAIN_NAME.SHIPMENT_XID</ShipmentRefnumValue>
						</ShipmentRefnum>
						<StatusCodeGid>
							<Gid>
								<DomainName>DOMAIN_NAME</DomainName>
								<Xid>IOD</Xid>
							</Gid>
						</StatusCodeGid>
						<EventDt>
							<GLogDate>20220331113800</GLogDate>
							<TZId>America/Cidade</TZId>
							<TZOffset>-03:00</TZOffset>
						</EventDt>
						<FlexFieldStrings/>
						<FlexFieldNumbers/>
						<FlexFieldDates/>
					</ShipmentStatus>
				</Shipment>
			</PlannedShipment>
		</GLogXMLElement>
	</TransmissionBody>
</Transmission>

Versão aplicável: 4.3.0 ou superior.